Skip to content

Conversation

samchon
Copy link
Owner

@samchon samchon commented Jun 22, 2025

This pull request introduces several updates across documentation, examples, and source code to enhance functionality, improve clarity, and fix inconsistencies. The key changes include the addition of a new AssertionGuard type definition, restructuring of example file paths, and updates to documentation for better formatting and accuracy.

New Features and Enhancements:

  • AssertionGuard Type Definition: Added a detailed type definition for assertion guard functions in typia, explaining their purpose, usage, and behavior. This includes examples and references to related documentation. (src/AssertionGuard.ts)

File Organization and Examples:

  • Restructured Example File Paths: Updated paths for example files to follow a more organized directory structure (e.g., examples/src/random/random-tag.ts instead of examples/src/random-tag.ts). This affects multiple files and references in the documentation. [1] [2] [3] [4]

Documentation Updates:

  • Improved Documentation Formatting: Fixed spacing and formatting in several documentation files to improve readability and consistency. For example, removed unnecessary blank lines and added proper spacing around headings. (website/pages/docs/index.mdx, website/pages/docs/setup.mdx) [1] [2] [3]
  • Updated RemoteSource Usage: Replaced inline code examples with references to RemoteSource components for better maintainability and dynamic loading of example code in documentation. (website/pages/docs/setup.mdx, website/pages/docs/validators/functional.mdx) [1] [2]

Bug Fixes:

  • Corrected File Name Typos: Fixed typos in file names referenced in documentation, such as changing application-hideden.ts to application-hidden.ts. (website/pages/docs/llm/strategy.mdx)

Codebase Maintenance:

  • Enhanced Fetch Error Handling: Updated the RemoteSource component to log errors when fetching files fails, improving debugging and reliability. (website/src/components/RemoteSource.tsx)

@samchon samchon requested a review from Copilot June 22, 2025 13:57
@samchon samchon self-assigned this Jun 22, 2025
@samchon samchon added bug Something isn't working documentation Improvements or additions to documentation labels Jun 22, 2025
Copy link

pkg-pr-new bot commented Jun 22, 2025

Open in StackBlitz

npm i https://pkg.pr.new/typia@1595

commit: 0a79a96

@samchon samchon merged commit 3476006 into master Jun 22, 2025
9 checks passed
@samchon samchon deleted the website/fix branch June 22, 2025 14:00
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR enhances the documentation site by improving error handling in the RemoteSource loader, reorganizing example file paths with updated references, refining formatting across multiple MDX files, and introducing a new AssertionGuard type for runtime type assertions.

  • Enhanced fetch error handling in the RemoteSource component
  • Restructured example directory paths and updated all corresponding MDX references
  • Added detailed AssertionGuard type definition and related docs

Reviewed Changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
website/src/components/RemoteSource.tsx Log and surface fetch errors when loading remote examples
website/pages/index.mdx Fixed blank lines and updated example comment from checkUUID.js
website/pages/docs/validators/functional.mdx Replaced inline TypeGuardError code block with RemoteSource
website/pages/docs/setup.mdx Imported RemoteSource and replaced inline code with RemoteSource
website/pages/docs/random.mdx Updated example URLs to new random/ subfolder structure
website/pages/docs/llm/strategy.mdx Corrected typo in example file name from hideden to hidden
website/pages/docs/index.mdx Cleaned blank lines and aligned example comment text
src/AssertionGuard.ts Added AssertionGuard<T> type definition with full docs
examples/src/random/random-tag.ts Removed stray trailing whitespace
examples/src/random/random-comment-tag.ts Added new comment-based random-tag example
README.md Updated example comment from checkUUID.js to checkString.js

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant