recipe-scrapers-js 0.1.0 → 1.0.0-rc.1

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+<!-- markdownlint-disable MD024 -->
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0-rc.1] - 2025-12-20
+
+### Added
+
+- chore: tsdown configuration file
+
+### Fixed
+
+- fix: main/module/type entriess in package.json; add exports field
+
+## [1.0.0-rc.0] - 2025-12-20
+
+### Added
+
+- Optional ingredient parsing via [parse-ingredient](https://github.com/jakeboone02/parse-ingredient)
+- `parse()` and `safeParse()` methods for Zod schema validated recipe extraction
+
+### Changed
+
+- **BREAKING**: Renamed `toObject()` method to `toRecipeObject()` for clarity
+- **BREAKING**: Ingredients and instructions now require grouped structures (each group has `name` and `items`) instead of flat arrays
+
+---
+
+## Pre-Release History
+
+Prior to version 1.0.0-rc.0, this project was in alpha development. No formal changelog was maintained during the alpha phase.
+
+[1.0.0-rc.0]: https://github.com/nerdstep/recipe-scrapers-js/releases/tag/v1.0.0-rc.0

package/README.md

@@ -4,18 +4,15 @@
 [![build](https://img.shields.io/github/actions/workflow/status/nerdstep/recipe-scrapers-js/ci.yml?branch=main&style=flat-square)](https://github.com/nerdstep/recipe-scrapers-js/actions)
 [![license](https://img.shields.io/npm/l/recipe-scrapers-js.svg?style=flat-square)](LICENSE)
 
-> **⚠️ Alpha Version**  
-> This library is currently in **alpha**, APIs and behavior may change without notice. Use at your own risk.
-
 A TypeScript/JavaScript library for scraping recipe data from various cooking websites. This is a JavaScript port inspired by the Python [recipe-scrapers](https://github.com/hhursev/recipe-scrapers) library.
 
 ## Features
 
-- 🍳 Extract structured recipe data from cooking websites
-- 🔍 Support for multiple popular recipe sites
-- 🚀 Built with TypeScript for better developer experience
-- ⚡ Fast and lightweight using Bun runtime for development and testing
-- 🧪 Comprehensive test coverage
+- Extract structured recipe data from cooking websites
+- Support for multiple popular recipe sites
+- Built with TypeScript for better developer experience
+- Fast and lightweight using the Bun runtime for development and testing
+- Comprehensive test coverage
 
 ## Installation
 
@@ -45,9 +42,12 @@ const url = 'https://allrecipes.com/recipe/example'
 // This function will throw if a scraper does not exist.
 const MyScraper = getScraper(url)
 const scraper = new MyScraper(html, url, /* { ...options } */)
-const recipe = await scraper.toObject()
 
-console.log(recipe)
+// Get the recipe data
+const rawRecipe = await scraper.toRecipeObject()
+
+// Get the schema validated recipe data
+const validatedRecipe = await scraper.parse()
 ```
 
 ### Options
@@ -79,9 +79,18 @@ interface ScraperOptions {
   /**
    * Logging level for the scraper.
    * This controls the verbosity of logs produced by the scraper.
-   * @default LogLevel.Warn
+   * @default LogLevel.WARN
    */
   logLevel?: LogLevel
+  /**
+   * Enable ingredient parsing using the parse-ingredient library.
+   * When enabled, each ingredient item will include a `parsed` field
+   * containing structured data (quantity, unit, description, etc.).
+   * Can be `true` for defaults or an options object.
+   * @see https://github.com/jakeboone02/parse-ingredient
+   * @default false
+   */
+  parseIngredients?: boolean | ParseIngredientOptions
 }
 ```
 
@@ -100,7 +109,7 @@ This library supports recipe extraction from various popular cooking websites. T
 ```bash
 # Clone the repository
 git clone https://github.com/nerdstep/recipe-scrapers-js.git
-cd recipe-scrapers
+cd recipe-scrapers-js
 
 # Install dependencies
 bun install
@@ -116,7 +125,7 @@ bun run build
 
 - `bun run build` - Build the library for distribution
 - `bun test` - Run the test suite
-- `bun test:coverage` - Run tests with coverage report
+- `bun test:coverage` - Run tests with a coverage report
 - `bun fetch-test-data` - Fetch test data from the original Python repository
 - `bun lint` - Run linting and type checking
 - `bun lint:fix` - Fix linting issues automatically
@@ -155,11 +164,16 @@ export class NewSiteScraper extends AbstractScraper {
   }
 
   protected extractIngredients(): RecipeFields['ingredients'] {
-    const items = this.$('.ingredient').map((_, el) =>
-      this.$(el).text().trim()
-    ).get()
-
-    return new Set(items)
+    const items = this.$('.ingredient')
+      .map((_, el) => this.$(el).text().trim())
+      .get()
+
+    return [
+      {
+        name: null,
+        items: items.map((value) => ({ value })),
+      },
+    ]
   }
   
   // ... implement other extraction methods
@@ -198,6 +212,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - [Schema.org Recipe specification](https://schema.org/Recipe)
 - [Cheerio](https://cheerio.js.org/) for HTML parsing
 - [Zod](https://zod.dev/) for schema validation
+- [parse-ingredient](https://github.com/jakeboone02/parse-ingredient) for ingredient parsing
 
 ## Copyright and Usage