@ingredient-icons/core 0.3.0 → 0.4.0

package/README.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <b>265 soft 3D icons for recipe apps, keyed by the Open Food Facts taxonomy.</b><br>
+  <b>324 soft 3D icons for recipe apps, keyed by the Open Food Facts taxonomy.</b><br>
   Shallots, crème fraîche, salt and pepper each get their own, and anything else borrows its closest parent's.
 </p>
 
@@ -53,25 +53,28 @@ export function Ingredient({ id, quantity, name }) {
 URLs point to the exact release you installed on jsDelivr, so icons never change under you. Pass `baseUrl` to serve them from your own CDN or app bundle. Works in React, React Native, Node, Bun, Deno and anything else that shows images, with TypeScript types included.
 
 ```ts
-import { findIcon, iconName, iconUrl } from "@ingredient-icons/core"
+import { findIcon, GENERIC_ID, iconName, iconUrl } from "@ingredient-icons/core"
 
 iconUrl("en:shallot", { size: 256 })
 // https://cdn.jsdelivr.net/npm/@ingredient-icons/core@<version>/icons/webp/256/en_shallot.webp
 
-findIcon("en:cherry-tomato")  // { id: "en:tomato", file: "en_tomato", exact: false }
+findIcon("en:peeled-tomatoes")  // { id: "en:tomato", file: "en_tomato", exact: false }
 iconName("en:shallot", "fr")  // "échalote"
-findIcon("en:unicorn-steak")  // undefined: show your own placeholder
+findIcon("en:unicorn-steak")  // undefined: the fallback is yours
+iconUrl("en:unicorn-steak") ?? iconUrl(GENERIC_ID)  // the generic icon, a cluster of fresh ingredients
 ```
 
+`GENERIC_ID` (`"generic"`) is a reserved id, not an Open Food Facts one: the icon to show when `findIcon` returns `undefined`, for an ingredient the taxonomy cannot place at all.
+
 [React](https://ingredient-icons.vercel.app/docs/guides/react) · [React Native](https://ingredient-icons.vercel.app/docs/guides/react-native) · [Next.js](https://ingredient-icons.vercel.app/docs/guides/nextjs) · [Self-hosting](https://ingredient-icons.vercel.app/docs/guides/self-hosting) · [Without npm](https://ingredient-icons.vercel.app/docs/guides/without-npm) · [API reference](https://ingredient-icons.vercel.app/docs/reference/api)
 
 ## No icon of its own? It borrows its parent's
 
-Ids follow the Open Food Facts taxonomy, which knows that fleur de sel is a sea salt and sea salt is a salt. When an ingredient has no icon, `findIcon` walks up its parents and takes the first one that has. That's how **265 icons cover 2,843 ingredients**.
+Ids follow the Open Food Facts taxonomy, which knows that fleur de sel is a sea salt and sea salt is a salt. When an ingredient has no icon, `findIcon` walks up its parents and takes the first one that has. That's how **324 icons cover 3,817 ingredients**.
 
 <p>
   <code>en:fleur-de-sel</code> → <code>en:sea-salt</code> → <img src="https://raw.githubusercontent.com/EBf-Studio/ingredient-icons/main/icons/png/128/en_salt.png" width="40" alt="" align="center"> <code>en:salt</code><br>
-  <code>en:cherry-tomato</code> → <img src="https://raw.githubusercontent.com/EBf-Studio/ingredient-icons/main/icons/png/128/en_tomato.png" width="40" alt="" align="center"> <code>en:tomato</code>
+  <code>en:peeled-tomatoes</code> → <img src="https://raw.githubusercontent.com/EBf-Studio/ingredient-icons/main/icons/png/128/en_tomato.png" width="40" alt="" align="center"> <code>en:tomato</code>
 </p>
 
 Try it with any ingredient [on the website](https://ingredient-icons.vercel.app).

package/dist/data.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.4.0";
 export declare const STYLE = 1;
 export declare const SIZES: readonly [64, 128, 256];
 export declare const TAXONOMY_RELEASE = "v2.118.0";