@rudra-js/react 0.1.0 → 0.2.0

package/README.md

@@ -31,13 +31,23 @@ your catalog.
 
 ## What comes from where
 
-This split is the reason a generated component is safe to put in a page.
+This split is what a rendered component rests on. The model decides how things
+are arranged and what the words are; every fact about a product is read from
+your catalog when the page is served, and the model's own words are rendered as
+text and escaped by React.
+
+| Decided by the model                                                | Decided by your catalog |
+| ------------------------------------------------------------------- | ----------------------- |
+| Which layout, in what order                                         | Every product title     |
+| Tone, headline, the words in each block                             | Every price             |
+| Only in per-shopper mode: which products, and how each is described | Every image and link    |
 
-| Decided by the model                       | Decided by your catalog |
-| ------------------------------------------ | ----------------------- |
-| Which layout, in what order                | Every product title     |
-| Which products, and how they are described | Every price             |
-| Tone, headline, badge text                 | Every image and link    |
+In the default cohort mode the products, their order and the reason under each
+are filled in per request, not by the model, and a badge the model wrote is
+dropped. The model chooses those only under `generation: 'per-shopper'`. The
+one thing it still picks in either mode is the product a hero names, and the
+full split is in
+[What the model decides, by mode](https://github.com/clivedsouza1010/rudra-js/tree/main/packages/core#what-the-model-decides-by-mode).
 
 The specification has no field carrying a title, a price, an image or a URL.
 Product facts are resolved at render time from `products`, keyed by a SKU
@@ -60,7 +70,7 @@ the starting point, not a fault.
 
 `examples/shop/public/demo-styles.css` is a working stylesheet written against
 nothing but the table below — copy it as a starting point. The example shop
-serves it behind `?styles=on` so you can see both states.
+applies it by default; `?styles=off` shows the raw markup.
 
 Every element it emits carries a class, and this is all of them:
 

package/dist/blocks/product-card.d.ts

@@ -4,9 +4,9 @@ import type { BlockRenderContext } from '../render-context.js';
  * One product.
  *
  * Every fact here — the title, the price, the image, the link — is read from
- * the catalog, not from the specification. The only things the model
- * contributes are `reason`, `badge` and `emphasis`, and React escapes all three
- * on the way into the markup.
+ * the catalog, not from the specification. The specification contributes only
+ * `reason`, `badge` and `emphasis`, and React escapes all three on the way
+ * into the markup.
  */
 export declare function ProductCard({ reference, context, }: {
     reference: ProductReference;

package/dist/blocks/product-card.js

@@ -3,9 +3,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * One product.
  *
  * Every fact here — the title, the price, the image, the link — is read from
- * the catalog, not from the specification. The only things the model
- * contributes are `reason`, `badge` and `emphasis`, and React escapes all three
- * on the way into the markup.
+ * the catalog, not from the specification. The specification contributes only
+ * `reason`, `badge` and `emphasis`, and React escapes all three on the way
+ * into the markup.
  */
 export function ProductCard({ reference, context, }) {
     const product = context.products.get(reference.sku);

package/dist/render-context.d.ts

@@ -8,8 +8,8 @@ import type { Bundle, Product } from '@rudra-js/core';
  * the model did not invent — both in stock at the time. A bundle member's SKU
  * comes from the set the shop supplied, not from the model. That division
  * is the whole reason a generated component is safe to put in a page — the
- * model decides what to show and how to describe it, and the shop decides what
- * is true about a product.
+ * model decides how the component reads, and the shop decides what is true
+ * about a product.
  */
 export interface BlockRenderContext {
     /** The host's catalog, keyed by SKU. Read-only: it is the caller's own map. */

package/dist/render-context.js

@@ -53,16 +53,15 @@ export function defaultFormatBundlePrice(bundle, locale) {
         throw new TypeError(`price for bundle ${bundle.id} is ${String(bundle.price)}, not a finite number — ` +
             'bundle objects must satisfy bundleSchema from @rudra-js/core');
     }
+    let formatter;
     try {
-        return new Intl.NumberFormat(locale, {
-            style: 'currency',
-            currency: bundle.currency,
-        }).format(bundle.price);
+        formatter = new Intl.NumberFormat(locale, { style: 'currency', currency: bundle.currency });
     }
     catch {
         // A bad locale, or a currency code Intl rejects on a hand-built bundle,
         // should not crash the page. A price nobody can punctuate is still a price.
         return `${bundle.currency} ${bundle.price}`;
     }
+    return formatter.format(bundle.price);
 }
 //# sourceMappingURL=render-context.js.map

package/dist/render-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAe;IAClE,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,SAAS,CACjB,iBAAiB,OAAO,CAAC,GAAG,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,0BAA0B;YAChF,gEAAgE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,SAA4B,CAAC;IACjC,IAAI,CAAC;QACH,2EAA2E;QAC3E,4EAA4E;QAC5E,mBAAmB;QACnB,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,yEAAyE;QACzE,uEAAuE;QACvE,uEAAuE;QACvE,kEAAkE;QAClE,4CAA4C;QAC5C,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,MAAe;IACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,SAAS,CACjB,oBAAoB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B;YAChF,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;YACnC,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,4EAA4E;QAC5E,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAe;IAClE,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,SAAS,CACjB,iBAAiB,OAAO,CAAC,GAAG,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,0BAA0B;YAChF,gEAAgE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,SAA4B,CAAC;IACjC,IAAI,CAAC;QACH,2EAA2E;QAC3E,4EAA4E;QAC5E,mBAAmB;QACnB,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,yEAAyE;QACzE,uEAAuE;QACvE,uEAAuE;QACvE,kEAAkE;QAClE,4CAA4C;QAC5C,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,MAAe;IACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,SAAS,CACjB,oBAAoB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B;YAChF,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,IAAI,SAA4B,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,4EAA4E;QAC5E,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rudra-js/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Renders a rudra component specification as React Server Components",
   "keywords": [
     "react",
@@ -23,7 +23,7 @@
     "directory": "packages/react"
   },
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.12.0"
   },
   "type": "module",
   "main": "./dist/index.js",
@@ -51,13 +51,13 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rudra-js/core": "^0.1.0",
+    "@rudra-js/core": "^0.2.0",
     "react": "^19.0.0"
   },
   "devDependencies": {
     "@rudra-js/core": "0.1.0",
     "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.5",
+    "@types/react-dom": "^19.2.7",
     "react": "^19.2.8",
     "react-dom": "^19.2.8"
   }

package/src/blocks/product-card.tsx

@@ -5,9 +5,9 @@ import type { BlockRenderContext } from '../render-context.js';
  * One product.
  *
  * Every fact here — the title, the price, the image, the link — is read from
- * the catalog, not from the specification. The only things the model
- * contributes are `reason`, `badge` and `emphasis`, and React escapes all three
- * on the way into the markup.
+ * the catalog, not from the specification. The specification contributes only
+ * `reason`, `badge` and `emphasis`, and React escapes all three on the way
+ * into the markup.
  */
 export function ProductCard({
   reference,

package/src/render-context.ts

@@ -9,8 +9,8 @@ import type { Bundle, Product } from '@rudra-js/core';
  * the model did not invent — both in stock at the time. A bundle member's SKU
  * comes from the set the shop supplied, not from the model. That division
  * is the whole reason a generated component is safe to put in a page — the
- * model decides what to show and how to describe it, and the shop decides what
- * is true about a product.
+ * model decides how the component reads, and the shop decides what is true
+ * about a product.
  */
 export interface BlockRenderContext {
   /** The host's catalog, keyed by SKU. Read-only: it is the caller's own map. */
@@ -86,14 +86,14 @@ export function defaultFormatBundlePrice(bundle: Bundle, locale?: string): strin
     );
   }
 
+  let formatter: Intl.NumberFormat;
   try {
-    return new Intl.NumberFormat(locale, {
-      style: 'currency',
-      currency: bundle.currency,
-    }).format(bundle.price);
+    formatter = new Intl.NumberFormat(locale, { style: 'currency', currency: bundle.currency });
   } catch {
     // A bad locale, or a currency code Intl rejects on a hand-built bundle,
     // should not crash the page. A price nobody can punctuate is still a price.
     return `${bundle.currency} ${bundle.price}`;
   }
+
+  return formatter.format(bundle.price);
 }