Skip to content

docs: clarify new URL asset handling - #1824

Merged
Timeless0911 merged 2 commits into
mainfrom
david/docs-new-url-assets
Aug 4, 2026
Merged

docs: clarify new URL asset handling#1824
Timeless0911 merged 2 commits into
mainfrom
david/docs-new-url-assets

Conversation

@Timeless0911

Copy link
Copy Markdown
Contributor

Summary

This PR updates the English and Chinese static asset docs for the new URL() behavior introduced in #1781.

  • Clarify URL asset output, built-in loader handling, and bundleless entry exclusions.
  • Document how to disable URL parsing globally or skip individual references with rspackIgnore, including asset copying and downstream consumption considerations.

Related Links

Checklist

  • Tests updated (or not required).
  • Documentation updated (or not required).

Copilot AI lite review requested due to automatic review settings August 4, 2026 11:30
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 4, 2026

Copy link
Copy Markdown

Deploying rslib with  Cloudflare Pages  Cloudflare Pages

Latest commit: cae3332
Status: ✅  Deploy successful!
Preview URL: https://c385c02e.rslib.pages.dev
Branch Preview URL: https://david-docs-new-url-assets.rslib.pages.dev

View logs

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cef4a0dcb0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread website/docs/en/guide/advanced/static-assets.mdx

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 refines the static asset documentation (English + Chinese) to match the new URL(path, import.meta.url) asset behavior introduced in #1781, including what gets emitted, how URL parsing interacts with built-in loaders, and how to opt out globally or per-reference.

Changes:

  • Clarifies that new URL() asset references are rewritten to point at emitted output assets (with updated examples).
  • Documents that certain file types referenced via new URL() are treated as URL assets and bypass built-in loaders.
  • Adds guidance for bundleless entry glob exclusions and opt-out mechanisms (disable URL parser / rspackIgnore).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
website/docs/en/guide/advanced/static-assets.mdx Updates English docs for new URL() asset emission, bundleless exclusions, and opt-out options.
website/docs/zh/guide/advanced/static-assets.mdx Updates Chinese docs for new URL() asset emission, bundleless exclusions, and opt-out options.

@Timeless0911
Timeless0911 merged commit 8d016f2 into main Aug 4, 2026
12 checks passed
@Timeless0911
Timeless0911 deleted the david/docs-new-url-assets branch August 4, 2026 12:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants