macieklamberski · macieklamberski · Jun 24, 2025 · Jun 27, 2025 · Jun 27, 2025 · Jul 30, 2025
diff --git a/README.md b/README.md
@@ -18,13 +18,6 @@ Feedsmith offers universal and format‑specific parsers that maintain the origi
 
 ---
 
-> [!IMPORTANT]
-> **Feedsmith 3.x is in final stages of development.** Check out the [v3.x guide](https://v3.feedsmith.dev/migration/v2-to-v3) to explore new features and learn how to upgrade. Install it with:
->
-> `npm install feedsmith@next`
-
----
-
 ## Features
 
 ### Core
@@ -53,7 +46,7 @@ Feedsmith offers universal and format‑specific parsers that maintain the origi
 
 ## Supported Formats
 
-Feedsmith aims to fully support all major feed formats and namespaces in complete alignment with their specifications.
+Feedsmith aims to fully support all major feed formats and namespaces in complete alignment with their specs.
 
 ✅ Available
 &nbsp;&nbsp;·&nbsp;&nbsp;
@@ -112,6 +105,7 @@ Feedsmith aims to fully support all major feed formats and namespaces in complet
 | [W3C Basic Geo](https://feedsmith.dev/reference/namespaces/geo) | `<geo:*>` | RSS, Atom | ✅ | ✅ |
 | [GeoRSS Simple](https://feedsmith.dev/reference/namespaces/georss) | `<georss:*>` | RSS, Atom, RDF | ✅ | ✅ |
 | [RDF](https://feedsmith.dev/reference/namespaces/rdf) | `<rdf:*>` | RDF | ✅ | ✅ |
+| [XML](https://feedsmith.dev/reference/namespaces/xml) | `<xml:*>` | RSS, Atom, RDF | ✅ | ✅ |
 
 ## Quick Start
 
@@ -231,7 +225,7 @@ try {
 Feedsmith provides comprehensive TypeScript types for all feed formats:
 
 ```typescript
-import type { Rss, Atom, Json, Opml } from 'feedsmith/types'
+import type { Rss, Atom, Json, Opml } from 'feedsmith'
 
 // Access all types for a format
 type Feed = Rss.Feed

diff --git a/benchmarks/javascript/bun.lock b/benchmarks/javascript/bun.lock
diff --git a/benchmarks/javascript/package.json b/benchmarks/javascript/package.json
@@ -9,15 +9,15 @@
     "benchmark": "^2.1.4",
     "feedme": "^2.0.2",
     "feedparser": "^2.3.1",
-    "feedsmith": "2.9.3",
+    "feedsmith": "2.9.4",
     "node-opml-parser": "^1.0.0",
     "opml": "^0.5.8",
     "opml-generator": "^1.1.1",
     "opml-to-json": "^1.0.1",
     "opmlparser": "^0.8.0",
     "podcast-feed-parser": "^1.0.4",
     "rss-parser": "^3.13.0",
-    "tinybench": "^6.0.0"
+    "tinybench": "^6.0.1"
   },
   "devDependencies": {
     "@types/benchmark": "^2.1.5",

diff --git a/compatibility/bundler/esm/index.ts b/compatibility/bundler/esm/index.ts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/cjs-package/index.cts b/compatibility/explicit-modules/cjs-package/index.cts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/cjs-package/index.mts b/compatibility/explicit-modules/cjs-package/index.mts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/esm-package/index.cts b/compatibility/explicit-modules/esm-package/index.cts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/esm-package/index.mts b/compatibility/explicit-modules/esm-package/index.mts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/mixed-package/index.cts b/compatibility/explicit-modules/mixed-package/index.cts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/mixed-package/index.mts b/compatibility/explicit-modules/mixed-package/index.mts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/explicit-modules/mixed-package/index.ts b/compatibility/explicit-modules/mixed-package/index.ts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/typescript/legacy-cjs/index.ts b/compatibility/typescript/legacy-cjs/index.ts
@@ -1,8 +1,7 @@
 // biome-ignore lint/style/noCommonJs: This file tests CJS compatibility.
 const { generateRssFeed, parseFeed } = require('feedsmith')
 
-import type { RssFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
+import type { Rss } from 'feedsmith'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -22,11 +21,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/typescript/modern-cjs/index.ts b/compatibility/typescript/modern-cjs/index.ts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/compatibility/typescript/modern-esm/index.ts b/compatibility/typescript/modern-esm/index.ts
@@ -1,6 +1,5 @@
-import type { RssFeed } from 'feedsmith'
+import type { Rss } from 'feedsmith'
 import { generateRssFeed, parseFeed } from 'feedsmith'
-import type { Rss } from 'feedsmith/types'
 
 const rssXml = `<?xml version="1.0" encoding="UTF-8"?>
 <rss version="2.0">
@@ -20,11 +19,4 @@ const feedData: Rss.Feed<Date> = {
   items: [],
 }
 
-const _legacyFeedData: RssFeed<Date> = {
-  title: 'Legacy Type',
-  link: 'https://example.com',
-  description: 'Legacy description',
-  items: [],
-}
-
 const _generatedRss = generateRssFeed(feedData)
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
@@ -55,8 +55,8 @@ export default defineConfig({
       { text: 'Parsing', link: '/parsing' },
       { text: 'Generating', link: '/generating' },
       {
-        text: 'v2.x',
-        items: [{ text: 'v3.x (Next)', link: 'https://v3.feedsmith.dev' }],
+        text: 'v3.0 (Next)',
+        items: [{ text: 'v2.0', link: 'https://feedsmith.dev' }],
       },
     ],
     sidebar: [
@@ -75,6 +75,7 @@ export default defineConfig({
           { text: 'Namespaces', link: '/parsing/namespaces' },
           { text: 'Dates', link: '/parsing/dates' },
           { text: 'Detecting', link: '/parsing/detecting' },
+          { text: 'Errors', link: '/parsing/errors' },
           { text: 'Examples', link: '/parsing/examples' },
         ],
       },
@@ -83,7 +84,8 @@ export default defineConfig({
         items: [
           { text: 'Overview', link: '/generating' },
           { text: 'Styling', link: '/generating/styling' },
-          { text: 'Lenient Mode', link: '/generating/lenient-mode' },
+          { text: 'Strict Mode', link: '/generating/strict-mode' },
+          { text: 'Errors', link: '/generating/errors' },
           { text: 'Examples', link: '/generating/examples' },
         ],
       },
@@ -140,6 +142,7 @@ export default defineConfig({
               { text: 'W3C Basic Geo', link: '/reference/namespaces/geo' },
               { text: 'GeoRSS Simple', link: '/reference/namespaces/georss' },
               { text: 'RDF', link: '/reference/namespaces/rdf' },
+              { text: 'XML', link: '/reference/namespaces/xml' },
             ],
           },
           {
@@ -154,7 +157,10 @@ export default defineConfig({
       },
       {
         text: 'Migration',
-        items: [{ text: 'From 1.x to 2.x', link: '/migration/v1-to-v2' }],
+        items: [
+          { text: 'From 2.x to 3.x', link: '/migration/v2-to-v3' },
+          { text: 'From 1.x to 2.x', link: '/migration/v1-to-v2' },
+        ],
       },
     ],
     search: {

diff --git a/docs/generating.md b/docs/generating.md
@@ -4,11 +4,7 @@ title: Generating Feeds
 
 # Generating Feeds
 
-Create RSS, Atom, JSON Feed, and OPML files with full namespace support.
-
-## Overview
-
-Feed generation is straightforward - provide the feed data and get back a properly formatted string:
+Create RSS, Atom, JSON Feed, and OPML files with full namespace support. Just provide the feed data and get back a properly formatted string:
 
 ```typescript
 import {