Skip to content

Comments

docs(ast): clarify behavior of TSModuleDeclaration::has_use_strict_directive#15730

Merged
graphite-app[bot] merged 1 commit intomainfrom
11-15-docs_ast_clarify_behavior_of_tsmoduledeclarationbody_has_use_strict_directive_
Nov 15, 2025
Merged

docs(ast): clarify behavior of TSModuleDeclaration::has_use_strict_directive#15730
graphite-app[bot] merged 1 commit intomainfrom
11-15-docs_ast_clarify_behavior_of_tsmoduledeclarationbody_has_use_strict_directive_

Conversation

@overlookmotel
Copy link
Member

@overlookmotel overlookmotel commented Nov 15, 2025

Expand docs for TSModuleDeclaration::has_use_strict_directive and TSModuleDeclarationBody::has_use_strict_directive, to clarify what they do in the case of nested TSModuleDeclarations. e.g.:

namespace X.Y.Z {
  "use strict";
}

@github-actions github-actions bot added the A-ast Area - AST label Nov 15, 2025
Copy link
Member Author


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • 0-merge - adds this PR to the back of the merge queue
  • hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions github-actions bot added the C-docs Category - Documentation. Related to user-facing or internal documentation label Nov 15, 2025
@overlookmotel overlookmotel force-pushed the 11-15-docs_ast_clarify_behavior_of_tsmoduledeclarationbody_has_use_strict_directive_ branch from e2fb8e0 to 927bc9f Compare November 15, 2025 16:41
@overlookmotel overlookmotel changed the title docs(ast): clarify behavior of TSModuleDeclarationBody::has_use_strict_directive docs(ast): clarify behavior of TSModuleDeclaration::has_use_strict_directive Nov 15, 2025
@overlookmotel overlookmotel marked this pull request as ready for review November 15, 2025 16:43
Copilot AI review requested due to automatic review settings November 15, 2025 16:43
@overlookmotel overlookmotel self-assigned this Nov 15, 2025
Copy link
Contributor

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 documentation for TypeScript module declaration methods by clarifying how has_use_strict_directive behaves with nested namespace declarations (e.g., namespace X.Y.Z).

Key Changes:

  • Expanded rustdoc comments for TSModuleDeclaration::has_use_strict_directive to explain behavior with nested declarations
  • Expanded rustdoc comments for TSModuleDeclarationBody::has_use_strict_directive with the same clarification

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@codspeed-hq
Copy link

codspeed-hq bot commented Nov 15, 2025

CodSpeed Performance Report

Merging #15730 will not alter performance

Comparing 11-15-docs_ast_clarify_behavior_of_tsmoduledeclarationbody_has_use_strict_directive_ (927bc9f) with main (d8d4e31)1

Summary

✅ 37 untouched

Footnotes

  1. No successful run was found on main (4608549) during the generation of this report, so d8d4e31 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report.

@overlookmotel
Copy link
Member Author

Docs-only change, and I've checked that the description accurately reflects the current behavior, and also that it's being used correctly by all callers. So merging without review.

@overlookmotel overlookmotel added the 0-merge Merge with Graphite Merge Queue label Nov 15, 2025
Copy link
Member Author

overlookmotel commented Nov 15, 2025

Merge activity

…irective` (#15730)

Expand docs for `TSModuleDeclaration::has_use_strict_directive` and `TSModuleDeclarationBody::has_use_strict_directive`, to clarify what they do in the case of nested `TSModuleDeclaration`s. e.g.:

```ts
namespace X.Y.Z {
  "use strict";
}
```
@graphite-app graphite-app bot force-pushed the 11-15-docs_ast_clarify_behavior_of_tsmoduledeclarationbody_has_use_strict_directive_ branch from 927bc9f to e033d50 Compare November 15, 2025 16:48
@graphite-app graphite-app bot merged commit e033d50 into main Nov 15, 2025
20 checks passed
@graphite-app graphite-app bot deleted the 11-15-docs_ast_clarify_behavior_of_tsmoduledeclarationbody_has_use_strict_directive_ branch November 15, 2025 16:53
@graphite-app graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Nov 15, 2025
graphite-app bot pushed a commit that referenced this pull request Nov 17, 2025
### 💥 BREAKING CHANGES

- ea51b0b napi: [**BREAKING**] Standardize function naming with sync suffixes (#15661) (Boshen)

### 🚀 Features

- 77efb76 parser: Improve error message for invalid switch clauses (#15728) (sapphi-red)
- 5691727 parser: Improve `import source` `from` error message (#15727) (sapphi-red)
- b7404bc parser: Improve error message for missing function body (#15726) (sapphi-red)
- 71c2fb0 parser: Improve error message when JSX is found while not enabled (#15725) (sapphi-red)
- 56e7e44 minifier: Disable removal of unnecessary `use strict` directives for DCE (#15691) (sapphi-red)
- 8a61cfd allocator, ast: Introduce `UnstableAddress` trait (#15700) (overlookmotel)
- f5ce55a napi: Export all options using wildcard exports (Boshen)
- 68703b9 minifier: Rotate binary expressions to remove parentheses (#15473) (sapphi-red)

### 🐛 Bug Fixes

- c023ba6 semantic: Do not duplicate statements in temp `Vec` when binding `TSModuleDeclaration`s (#15724) (overlookmotel)
- d60ca81 parser: Reject `import something 'source'` (#15746) (sapphi-red)
- e0728fa ast: Exclude comment end position from `is_inside_comment` check (#15753) (camc314)
- 9f54a36 semantic: Error on `\00` in strict mode (#15743) (sapphi-red)
- 440a977 ast: Include rest properties when using `get_binding_identifiers` (#15710) (camc314)

### ⚡ Performance

- 1f09d3c parser: Faster checking for invalid modifiers (#15717) (overlookmotel)
- d8d4e31 ast: Use loop instead of recursion in `TSModuleDeclarationBody::as_module_block_mut` (#15713) (overlookmotel)

### 📚 Documentation

- e033d50 ast: Clarify behavior of `TSModuleDeclaration::has_use_strict_directive` (#15730) (overlookmotel)
- 9eda70f allocator: Improve docs for `Address` methods (#15697) (overlookmotel)
overlookmotel pushed a commit that referenced this pull request Nov 17, 2025
### 💥 BREAKING CHANGES

- ea51b0b napi: [**BREAKING**] Standardize function naming with sync
suffixes (#15661) (Boshen)

### 🚀 Features

- 77efb76 parser: Improve error message for invalid switch clauses
(#15728) (sapphi-red)
- 5691727 parser: Improve `import source` `from` error message (#15727)
(sapphi-red)
- b7404bc parser: Improve error message for missing function body
(#15726) (sapphi-red)
- 71c2fb0 parser: Improve error message when JSX is found while not
enabled (#15725) (sapphi-red)
- 56e7e44 minifier: Disable removal of unnecessary `use strict`
directives for DCE (#15691) (sapphi-red)
- 8a61cfd allocator, ast: Introduce `UnstableAddress` trait (#15700)
(overlookmotel)
- f5ce55a napi: Export all options using wildcard exports (Boshen)
- 68703b9 minifier: Rotate binary expressions to remove parentheses
(#15473) (sapphi-red)

### 🐛 Bug Fixes

- c023ba6 semantic: Do not duplicate statements in temp `Vec` when
binding `TSModuleDeclaration`s (#15724) (overlookmotel)
- d60ca81 parser: Reject `import something 'source'` (#15746)
(sapphi-red)
- e0728fa ast: Exclude comment end position from `is_inside_comment`
check (#15753) (camc314)
- 9f54a36 semantic: Error on `\00` in strict mode (#15743) (sapphi-red)
- 440a977 ast: Include rest properties when using
`get_binding_identifiers` (#15710) (camc314)

### ⚡ Performance

- 1f09d3c parser: Faster checking for invalid modifiers (#15717)
(overlookmotel)
- d8d4e31 ast: Use loop instead of recursion in
`TSModuleDeclarationBody::as_module_block_mut` (#15713) (overlookmotel)

### 📚 Documentation

- e033d50 ast: Clarify behavior of
`TSModuleDeclaration::has_use_strict_directive` (#15730) (overlookmotel)
- 9eda70f allocator: Improve docs for `Address` methods (#15697)
(overlookmotel)
taearls pushed a commit to taearls/oxc that referenced this pull request Dec 11, 2025
…irective` (oxc-project#15730)

Expand docs for `TSModuleDeclaration::has_use_strict_directive` and `TSModuleDeclarationBody::has_use_strict_directive`, to clarify what they do in the case of nested `TSModuleDeclaration`s. e.g.:

```ts
namespace X.Y.Z {
  "use strict";
}
```
taearls pushed a commit to taearls/oxc that referenced this pull request Dec 11, 2025
### 💥 BREAKING CHANGES

- ea51b0b napi: [**BREAKING**] Standardize function naming with sync
suffixes (oxc-project#15661) (Boshen)

### 🚀 Features

- 77efb76 parser: Improve error message for invalid switch clauses
(oxc-project#15728) (sapphi-red)
- 5691727 parser: Improve `import source` `from` error message (oxc-project#15727)
(sapphi-red)
- b7404bc parser: Improve error message for missing function body
(oxc-project#15726) (sapphi-red)
- 71c2fb0 parser: Improve error message when JSX is found while not
enabled (oxc-project#15725) (sapphi-red)
- 56e7e44 minifier: Disable removal of unnecessary `use strict`
directives for DCE (oxc-project#15691) (sapphi-red)
- 8a61cfd allocator, ast: Introduce `UnstableAddress` trait (oxc-project#15700)
(overlookmotel)
- f5ce55a napi: Export all options using wildcard exports (Boshen)
- 68703b9 minifier: Rotate binary expressions to remove parentheses
(oxc-project#15473) (sapphi-red)

### 🐛 Bug Fixes

- c023ba6 semantic: Do not duplicate statements in temp `Vec` when
binding `TSModuleDeclaration`s (oxc-project#15724) (overlookmotel)
- d60ca81 parser: Reject `import something 'source'` (oxc-project#15746)
(sapphi-red)
- e0728fa ast: Exclude comment end position from `is_inside_comment`
check (oxc-project#15753) (camc314)
- 9f54a36 semantic: Error on `\00` in strict mode (oxc-project#15743) (sapphi-red)
- 440a977 ast: Include rest properties when using
`get_binding_identifiers` (oxc-project#15710) (camc314)

### ⚡ Performance

- 1f09d3c parser: Faster checking for invalid modifiers (oxc-project#15717)
(overlookmotel)
- d8d4e31 ast: Use loop instead of recursion in
`TSModuleDeclarationBody::as_module_block_mut` (oxc-project#15713) (overlookmotel)

### 📚 Documentation

- e033d50 ast: Clarify behavior of
`TSModuleDeclaration::has_use_strict_directive` (oxc-project#15730) (overlookmotel)
- 9eda70f allocator: Improve docs for `Address` methods (oxc-project#15697)
(overlookmotel)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-ast Area - AST C-docs Category - Documentation. Related to user-facing or internal documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant