docs/2.guide/2.directory-structure/1.shared.md (1)

80-81: Add a brief note explaining why .d.ts is discouraged here.

A one-liner will pre-empt questions: .d.ts files are for ambient declarations, aren’t transpiled, and can confuse tooling/auto‑imports; prefer .ts with export type/interface.

Apply after the directory block:

  -----| bar.ts             # Auto-imported

+::tip
+Prefer .ts over .d.ts in shared/types/. .d.ts files are for ambient declarations only and aren’t transpiled; using .ts with export type/interface plays better with editor tooling and Nuxt’s scanning.
+::
+
Any other files you create in the shared/ folder must be manually imported using the #shared alias (automatically configured by Nuxt):

</blockquote></details>

</blockquote></details>

<details>
<summary>📜 Review details</summary>

**Configuration used**: CodeRabbit UI

**Review profile**: CHILL

**Plan**: Pro

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 43f07f8100649c7cd3b4698504471df5ebc47510 and 45d134ba22e53906af033892d9ba9816c1756fbe.

</details>

<details>
<summary>📒 Files selected for processing (1)</summary>

* `docs/2.guide/2.directory-structure/1.shared.md` (1 hunks)

</details>

<details>
<summary>🔇 Additional comments (1)</summary><blockquote>

<details>
<summary>docs/2.guide/2.directory-structure/1.shared.md (1)</summary><blockquote>

`80-81`: **LGTM: replacing `bar.d.ts` with `bar.ts` in the example is correct.**

This better reflects recommended practice for `shared/types` (type exports from `.ts` files instead of ambient `.d.ts`).

</blockquote></details>

</blockquote></details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->