Nuri Preview

Nuri Preview brings live component previews for Nuri WPF projects directly into Visual Studio 2022.

Open a Nuri component, launch the preview tool window, and inspect your UI without repeatedly restarting the application. Saving a C# source file automatically requests a preview refresh.

Nuri Preview is currently an early preview release. Features and behavior may change as the Nuri runtime evolves.

Features

• Preview Nuri WPF components inside a Visual Studio tool window
• Automatically refresh the preview when C# source files are saved
• Manually refresh the current preview
• Zoom from 25% to 400%
• Reset, center, and fit the preview
• Resolve the preview project from the active C# document
• Fall back to the selected Startup Project
• Display build and preview status directly in the tool window
• Run project compilation and preview rendering locally

Getting Started

1. Open a solution containing a Nuri WPF project.
2. Select the intended project as the Startup Project, or open one of its C# files.
3. Open Nuri Preview using one of the following locations:
   • View > Nuri Preview
   • Tools > Nuri Preview
   • Right-click inside the C# editor and select Nuri Preview
4. Save a C# file to refresh the preview.
5. Use the toolbar to refresh, zoom, center, or fit the preview.

Component Discovery

A previewable component must:

• Inherit from Nuri.UI.Dsl.Component
• Have a public parameterless constructor

Nuri Preview determines the root component from calls such as:

NuriApplication.Run<MyComponent>();
NuriApplication.Show<MyComponent>();
NuriApplication.Attach<MyComponent>();

If the project contains only one previewable component, that component may be selected automatically.

## Requirements

- Visual Studio 2022 Community, Professional, or Enterprise
- 64-bit Windows
- .NET Framework 4.7.2 or later
- .NET 8 Desktop Runtime
- A Nuri WPF project

## Current Limitations

- The current preview renderer targets Nuri WPF projects.
- Components requiring constructor arguments cannot be selected as preview roots.
- Code with build or compilation errors cannot be rendered.
- Some application-level resources or startup initialization may need additional preview support.
- This release is intended for evaluation and development feedback.

## Privacy

Nuri Preview does not include telemetry and does not send source code to remote services. Project compilation and preview rendering run locally on your
machine.

## Feedback

Bug reports and feature requests are welcome.

When reporting a problem, please include:

- Visual Studio version
- .NET version
- Nuri version
- Reproduction steps
- Relevant build or preview error messages

## License

License information will be provided with the Nuri project.

---

# Nuri Preview 한국어 안내

Nuri Preview는 Nuri WPF 프로젝트의 컴포넌트를 Visual Studio 2022 안에서 바로 미리 볼 수 있게 해주는 확장입니다.

Nuri 컴포넌트를 열고 Preview 도구 창을 실행하면 애플리케이션을 반복해서 재시작하지 않고 UI를 확인할 수 있습니다. C# 소스 파일을 저장하면 Preview 갱신이 자동
으로 요청됩니다.

> Nuri Preview는 현재 초기 Preview 버전입니다. Nuri Runtime의 발전에 따라 기능과 동작이 변경될 수 있습니다.

## 주요 기능

- Visual Studio 도구 창에서 Nuri WPF 컴포넌트 미리보기
- C# 소스 파일 저장 시 Preview 자동 갱신
- 현재 Preview 수동 새로고침
- 25%부터 400%까지 확대 및 축소
- 배율 초기화, 가운데 정렬 및 창 크기에 맞춤
- 현재 열려 있는 C# 문서에서 Preview 프로젝트 자동 탐색
- Startup Project를 통한 프로젝트 탐색
- 도구 창에서 빌드 및 Preview 상태 확인
- 프로젝트 컴파일과 Preview 렌더링을 로컬 환경에서 실행

## 사용 방법

1. Nuri WPF 프로젝트가 포함된 솔루션을 엽니다.
2. Preview할 프로젝트를 Startup Project로 지정하거나 해당 프로젝트의 C# 파일을 엽니다.
3. 다음 위치 중 하나에서 **Nuri Preview**를 실행합니다.
   - **View > Nuri Preview**
   - **Tools > Nuri Preview**
   - C# 편집기에서 마우스 오른쪽 버튼 클릭 후 **Nuri Preview**
4. C# 파일을 저장하면 Preview가 자동으로 갱신됩니다.
5. 도구 모음에서 새로고침, 확대 및 축소, 가운데 정렬, 창 맞춤 기능을 사용할 수 있습니다.

## 컴포넌트 탐색

Preview할 수 있는 컴포넌트는 다음 조건을 만족해야 합니다.

- `Nuri.UI.Dsl.Component`를 상속해야 합니다.
- public 매개변수 없는 생성자가 있어야 합니다.

Nuri Preview는 다음과 같은 호출에서 루트 컴포넌트를 찾습니다.

```csharp
NuriApplication.Run<MyComponent>();
NuriApplication.Show<MyComponent>();
NuriApplication.Attach<MyComponent>();

프로젝트에 Preview 가능한 컴포넌트가 하나만 있다면 해당 컴포넌트가 자동으로 선택될 수 있습니다.

## 요구 사항

- Visual Studio 2022 Community, Professional 또는 Enterprise
- 64비트 Windows
- .NET Framework 4.7.2 이상
- .NET 8 Desktop Runtime
- Nuri WPF 프로젝트

## 현재 제한 사항

- 현재 Preview Renderer는 Nuri WPF 프로젝트를 대상으로 합니다.
- 생성자 매개변수가 필요한 컴포넌트는 Preview 루트로 선택할 수 없습니다.
- 빌드 또는 컴파일 오류가 있는 코드는 렌더링할 수 없습니다.
- 일부 애플리케이션 리소스나 시작 초기화 코드는 추가적인 Preview 지원이 필요할 수 있습니다.
- 이 릴리스는 기능 평가와 개발 피드백을 위한 초기 버전입니다.

## 개인정보 보호

Nuri Preview에는 텔레메트리가 포함되어 있지 않으며 소스 코드를 외부 서비스로 전송하지 않습니다. 프로젝트 컴파일과 Preview 렌더링은 사용자 컴퓨터에서 로컬로
실행됩니다.

## 피드백

버그 제보와 기능 요청을 환영합니다.

문제를 제보할 때는 다음 정보를 포함해 주세요.

- Visual Studio 버전
- .NET 버전
- Nuri 버전
- 문제 재현 절차
- 관련 빌드 또는 Preview 오류 메시지

## 라이선스

라이선스 정보는 Nuri 프로젝트와 함께 제공될 예정입니다.