@rudra-js/react 0.6.0 → 0.7.1

package/README.md

@@ -1,17 +1,20 @@
 # @rudra-js/react
 
 Renders a component specification from
-[`@rudra-js/core`](https://github.com/clivedsouza1010/rudra-js/tree/main/packages/core) as React
-Server Components.
+[`@rudra-js/core`](https://github.com/clivedsouza1010/rudra-js/tree/main/packages/core) with React
+18 or 19.
 
-No client JavaScript. The recommendation area arrives in the initial HTML response and needs no
-hydration, so it never pops in the way a client-fetched recommendation rail does, and a crawler that
-doesn't run JavaScript still reads it.
+The components are plain functions with no hooks, state or effects. They work with
+`renderToString`, in a client-rendered app, and as Server Components in a setup that supports them,
+such as the Next.js App Router. Rendered on the server, the
+recommendation area arrives in the initial HTML response and needs no client JavaScript, so it never
+pops in the way a client-fetched recommendation rail does, and a crawler that doesn't run JavaScript
+still reads it.
 
 ## Install
 
 ```sh
-npm install @rudra-js/react @rudra-js/core react zod@^4
+npm install @rudra-js/react @rudra-js/core react
 ```
 
 Both `@rudra-js/core` and `react` are peer dependencies. The specification you pass in comes from

package/dist/index.d.ts

@@ -1,9 +1,3 @@
-/**
- * @rudra-js/react — renders a component specification as React Server Components.
- *
- * Carries no client JavaScript. The recommendation area arrives in the initial
- * HTML response and needs no hydration.
- */
 export { RudraComponent, type ProductCatalog, type RudraComponentProps, } from './rudra-component.js';
 export { defaultRegistry, extendRegistry, type BlockRegistry, type BlockRenderer, } from './registry.js';
 export { defaultFormatBundlePrice, defaultFormatPrice, defaultHrefForSku, type BlockRenderContext, } from './render-context.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,14 +1,5 @@
-/**
- * @rudra-js/react — renders a component specification as React Server Components.
- *
- * Carries no client JavaScript. The recommendation area arrives in the initial
- * HTML response and needs no hydration.
- */
 export { RudraComponent, } from './rudra-component.js';
 export { defaultRegistry, extendRegistry, } from './registry.js';
 export { defaultFormatBundlePrice, defaultFormatPrice, defaultHrefForSku, } from './render-context.js';
-// The six default renderers reach hosts through `defaultRegistry`, which is
-// also the thing they need in order to override one. `ProductCard` is exported
-// on its own because a custom grid renderer still wants the standard card.
 export { ProductCard } from './blocks/product-card.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/registry.d.ts

@@ -1,13 +1,3 @@
-/**
- * What each kind of block actually renders.
- *
- * This is the seam that makes a generated component safe *and* usable. The
- * model picks from a fixed vocabulary of block kinds; the registry decides what
- * those kinds look like. A shop can swap any entry for its own design-system
- * component without the model knowing, without the specification changing, and
- * without giving the model any new ability — it still cannot say anything
- * outside the vocabulary.
- */
 import type { ReactNode } from 'react';
 import type { Block, BlockKind } from '@rudra-js/core';
 import type { BlockRenderContext } from './render-context.js';
@@ -21,13 +11,5 @@ export type BlockRegistry = {
     [Kind in BlockKind]: BlockRenderer<Kind>;
 };
 export declare const defaultRegistry: BlockRegistry;
-/**
- * Replaces some renderers and keeps the rest.
- *
- * Written out kind by kind rather than spread: a spread lets
- * `{ hero: maybeRenderer }` put an explicit `undefined` over the default, and
- * the page then renders every hero as nothing. Here an absent override means
- * the default, however it was written.
- */
 export declare function extendRegistry(overrides: Partial<BlockRegistry>): BlockRegistry;
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAU9D,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,SAAS,IAAI,CAAC,KAAK,EAAE;IAC1D,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACtC,OAAO,EAAE,kBAAkB,CAAC;CAC7B,KAAK,SAAS,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG;KACzB,IAAI,IAAI,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAO7B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAS/E"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAU9D,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,SAAS,IAAI,CAAC,KAAK,EAAE;IAC1D,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACtC,OAAO,EAAE,kBAAkB,CAAC;CAC7B,KAAK,SAAS,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG;KACzB,IAAI,IAAI,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAO7B,CAAC;AAEF,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAS/E"}

package/dist/registry.js

@@ -1,13 +1,3 @@
-/**
- * What each kind of block actually renders.
- *
- * This is the seam that makes a generated component safe *and* usable. The
- * model picks from a fixed vocabulary of block kinds; the registry decides what
- * those kinds look like. A shop can swap any entry for its own design-system
- * component without the model knowing, without the specification changing, and
- * without giving the model any new ability — it still cannot say anything
- * outside the vocabulary.
- */
 import { BannerRenderer, CarouselRenderer, CopyRenderer, GridRenderer, HeroRenderer, } from './blocks/block-renderers.js';
 import { BundleRenderer } from './blocks/bundle-block.js';
 export const defaultRegistry = {
@@ -18,14 +8,6 @@ export const defaultRegistry = {
     copy: CopyRenderer,
     bundle: BundleRenderer,
 };
-/**
- * Replaces some renderers and keeps the rest.
- *
- * Written out kind by kind rather than spread: a spread lets
- * `{ hero: maybeRenderer }` put an explicit `undefined` over the default, and
- * the page then renders every hero as nothing. Here an absent override means
- * the default, however it was written.
- */
 export function extendRegistry(overrides) {
     return {
         hero: overrides.hero ?? defaultRegistry.hero,

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAW1D,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiC;IAC9D,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;QAC5C,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;QAC5C,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,eAAe,CAAC,QAAQ;QACxD,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM;QAClD,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;QAC5C,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM;KACnD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAW1D,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;CACvB,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,SAAiC;IAC9D,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;QAC5C,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;QAC5C,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,eAAe,CAAC,QAAQ;QACxD,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM;QAClD,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;QAC5C,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM;KACnD,CAAC;AACJ,CAAC"}

package/dist/render-context.d.ts

@@ -1,56 +1,13 @@
 import type { Bundle, Product } from '@rudra-js/core';
-/**
- * Everything a block renderer needs that does not come from the specification.
- *
- * Note what is absent from the spec and present here: a price, a title, an
- * image, a link. Those are resolved from the host's own catalog, keyed by a SKU
- * that `selectProducts` drew from that same catalog and `reconcileSpec` proved
- * 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 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. */
     readonly products: ReadonlyMap<string, Product>;
-    /** Sets the shop sells together, keyed by id. */
     readonly bundles: ReadonlyMap<string, Bundle>;
-    /** Host-owned link construction. */
     readonly hrefForSku: (sku: string) => string;
     readonly formatPrice: (product: Product) => string;
     readonly formatBundlePrice: (bundle: Bundle) => string;
 }
 export declare function defaultHrefForSku(sku: string): string;
-/**
- * The product to draw for a SKU, or nothing.
- *
- * A row the catalog flags out of stock counts as absent. Core only ever names
- * an in-stock candidate, but the catalog passed here is read later and can be
- * the fresher of the two — and a card that prices and links something the shop
- * cannot sell is worse than one card fewer. A catalog that leaves the field
- * off renders as it always did.
- */
 export declare function sellableProduct(products: ReadonlyMap<string, Product>, sku: string): Product | undefined;
-/**
- * Formats a price the way the currency itself is written.
- *
- * No digit count is specified on purpose. Two decimal places is a dollar-and-
- * cent assumption, and forcing it is wrong in both directions: Kuwaiti dinar and
- * Bahraini dinar have three, so a real digit of the price disappears, and yen has
- * none, so a price gains a fraction that does not exist. Intl already knows the
- * right number for each currency.
- *
- * `locale` decides how the number is punctuated and where the symbol sits.
- * Left undefined it falls back to the server's locale, which is almost never
- * the shopper's — a shop serving more than one should pass the shopper's.
- */
 export declare function defaultFormatPrice(product: Product, locale?: string): string;
-/**
- * Formats a bundle's price, in the currency the shop put on the bundle.
- *
- * The price and the currency come from the same object, so a set whose members
- * are priced in another currency still shows the shop's own price correctly.
- */
 export declare function defaultFormatBundlePrice(bundle: Bundle, locale?: string): string;
 //# sourceMappingURL=render-context.d.ts.map

package/dist/render-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACxD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,GAAG,EAAE,MAAM,GACV,OAAO,GAAG,SAAS,CAGrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBhF"}
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACxD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,GAAG,EAAE,MAAM,GACV,OAAO,GAAG,SAAS,CAGrB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBhF"}

package/dist/render-context.js

@@ -1,32 +1,10 @@
 export function defaultHrefForSku(sku) {
     return `/product/${encodeURIComponent(sku)}`;
 }
-/**
- * The product to draw for a SKU, or nothing.
- *
- * A row the catalog flags out of stock counts as absent. Core only ever names
- * an in-stock candidate, but the catalog passed here is read later and can be
- * the fresher of the two — and a card that prices and links something the shop
- * cannot sell is worse than one card fewer. A catalog that leaves the field
- * off renders as it always did.
- */
 export function sellableProduct(products, sku) {
     const product = products.get(sku);
     return product?.isInStock === false ? undefined : product;
 }
-/**
- * Formats a price the way the currency itself is written.
- *
- * No digit count is specified on purpose. Two decimal places is a dollar-and-
- * cent assumption, and forcing it is wrong in both directions: Kuwaiti dinar and
- * Bahraini dinar have three, so a real digit of the price disappears, and yen has
- * none, so a price gains a fraction that does not exist. Intl already knows the
- * right number for each currency.
- *
- * `locale` decides how the number is punctuated and where the symbol sits.
- * Left undefined it falls back to the server's locale, which is almost never
- * the shopper's — a shop serving more than one should pass the shopper's.
- */
 export function defaultFormatPrice(product, locale) {
     if (!Number.isFinite(product.price)) {
         throw new TypeError(`price for SKU ${product.sku} is ${String(product.price)}, not a finite number — ` +
@@ -34,8 +12,6 @@ export function defaultFormatPrice(product, locale) {
     }
     let formatter;
     try {
-        // Only the constructor: guarding format() too would swallow a throwing
-        // getter on a host's own Product and render the mess as a price.
         formatter = new Intl.NumberFormat(locale, { style: 'currency', currency: product.currency });
     }
     catch {
@@ -43,12 +19,6 @@ export function defaultFormatPrice(product, locale) {
     }
     return formatter.format(product.price);
 }
-/**
- * Formats a bundle's price, in the currency the shop put on the bundle.
- *
- * The price and the currency come from the same object, so a set whose members
- * are priced in another currency still shows the shop's own price correctly.
- */
 export function defaultFormatBundlePrice(bundle, locale) {
     if (!Number.isFinite(bundle.price)) {
         throw new TypeError(`price for bundle ${bundle.id} is ${String(bundle.price)}, not a finite number — ` +

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;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAsC,EACtC,GAAW;IAEX,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,OAAO,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAe;IAClE,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,uEAAuE;QACvE,iEAAiE;QACjE,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,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,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"}
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAsC,EACtC,GAAW;IAEX,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,OAAO,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAe;IAClE,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,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,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,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,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,7 +1,7 @@
 {
   "name": "@rudra-js/react",
-  "version": "0.6.0",
-  "description": "Renders a rudra component specification as React Server Components",
+  "version": "0.7.1",
+  "description": "Renders a rudra component specification with React 18 or 19, on the server or in the browser",
   "keywords": [
     "react",
     "react-server-components",
@@ -13,7 +13,7 @@
   ],
   "license": "MIT",
   "author": "Clive Dsouza",
-  "homepage": "https://github.com/clivedsouza1010/rudra-js/tree/main/packages/react#readme",
+  "homepage": "https://rudrajs.com",
   "bugs": {
     "url": "https://github.com/clivedsouza1010/rudra-js/issues"
   },
@@ -51,11 +51,11 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rudra-js/core": "^0.6.0",
+    "@rudra-js/core": "^0.7.1",
     "react": "^18.2.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@rudra-js/core": "0.6.0",
+    "@rudra-js/core": "0.7.1",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "react": "^19.3.0",

package/src/index.ts

@@ -1,10 +1,3 @@
-/**
- * @rudra-js/react — renders a component specification as React Server Components.
- *
- * Carries no client JavaScript. The recommendation area arrives in the initial
- * HTML response and needs no hydration.
- */
-
 export {
   RudraComponent,
   type ProductCatalog,
@@ -25,7 +18,4 @@ export {
   type BlockRenderContext,
 } from './render-context.js';
 
-// The six default renderers reach hosts through `defaultRegistry`, which is
-// also the thing they need in order to override one. `ProductCard` is exported
-// on its own because a custom grid renderer still wants the standard card.
 export { ProductCard } from './blocks/product-card.js';

package/src/registry.ts

@@ -1,14 +1,3 @@
-/**
- * What each kind of block actually renders.
- *
- * This is the seam that makes a generated component safe *and* usable. The
- * model picks from a fixed vocabulary of block kinds; the registry decides what
- * those kinds look like. A shop can swap any entry for its own design-system
- * component without the model knowing, without the specification changing, and
- * without giving the model any new ability — it still cannot say anything
- * outside the vocabulary.
- */
-
 import type { ReactNode } from 'react';
 import type { Block, BlockKind } from '@rudra-js/core';
 import type { BlockRenderContext } from './render-context.js';
@@ -39,14 +28,6 @@ export const defaultRegistry: BlockRegistry = {
   bundle: BundleRenderer,
 };
 
-/**
- * Replaces some renderers and keeps the rest.
- *
- * Written out kind by kind rather than spread: a spread lets
- * `{ hero: maybeRenderer }` put an explicit `undefined` over the default, and
- * the page then renders every hero as nothing. Here an absent override means
- * the default, however it was written.
- */
 export function extendRegistry(overrides: Partial<BlockRegistry>): BlockRegistry {
   return {
     hero: overrides.hero ?? defaultRegistry.hero,

package/src/render-context.ts

@@ -1,23 +1,10 @@
 import type { Bundle, Product } from '@rudra-js/core';
 
-/**
- * Everything a block renderer needs that does not come from the specification.
- *
- * Note what is absent from the spec and present here: a price, a title, an
- * image, a link. Those are resolved from the host's own catalog, keyed by a SKU
- * that `selectProducts` drew from that same catalog and `reconcileSpec` proved
- * 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 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. */
   readonly products: ReadonlyMap<string, Product>;
-  /** Sets the shop sells together, keyed by id. */
+
   readonly bundles: ReadonlyMap<string, Bundle>;
-  /** Host-owned link construction. */
+
   readonly hrefForSku: (sku: string) => string;
   readonly formatPrice: (product: Product) => string;
   readonly formatBundlePrice: (bundle: Bundle) => string;
@@ -27,15 +14,6 @@ export function defaultHrefForSku(sku: string): string {
   return `/product/${encodeURIComponent(sku)}`;
 }
 
-/**
- * The product to draw for a SKU, or nothing.
- *
- * A row the catalog flags out of stock counts as absent. Core only ever names
- * an in-stock candidate, but the catalog passed here is read later and can be
- * the fresher of the two — and a card that prices and links something the shop
- * cannot sell is worse than one card fewer. A catalog that leaves the field
- * off renders as it always did.
- */
 export function sellableProduct(
   products: ReadonlyMap<string, Product>,
   sku: string,
@@ -44,19 +22,6 @@ export function sellableProduct(
   return product?.isInStock === false ? undefined : product;
 }
 
-/**
- * Formats a price the way the currency itself is written.
- *
- * No digit count is specified on purpose. Two decimal places is a dollar-and-
- * cent assumption, and forcing it is wrong in both directions: Kuwaiti dinar and
- * Bahraini dinar have three, so a real digit of the price disappears, and yen has
- * none, so a price gains a fraction that does not exist. Intl already knows the
- * right number for each currency.
- *
- * `locale` decides how the number is punctuated and where the symbol sits.
- * Left undefined it falls back to the server's locale, which is almost never
- * the shopper's — a shop serving more than one should pass the shopper's.
- */
 export function defaultFormatPrice(product: Product, locale?: string): string {
   if (!Number.isFinite(product.price)) {
     throw new TypeError(
@@ -67,8 +32,6 @@ export function defaultFormatPrice(product: Product, locale?: string): string {
 
   let formatter: Intl.NumberFormat;
   try {
-    // Only the constructor: guarding format() too would swallow a throwing
-    // getter on a host's own Product and render the mess as a price.
     formatter = new Intl.NumberFormat(locale, { style: 'currency', currency: product.currency });
   } catch {
     return `${product.currency} ${product.price}`;
@@ -77,12 +40,6 @@ export function defaultFormatPrice(product: Product, locale?: string): string {
   return formatter.format(product.price);
 }
 
-/**
- * Formats a bundle's price, in the currency the shop put on the bundle.
- *
- * The price and the currency come from the same object, so a set whose members
- * are priced in another currency still shows the shop's own price correctly.
- */
 export function defaultFormatBundlePrice(bundle: Bundle, locale?: string): string {
   if (!Number.isFinite(bundle.price)) {
     throw new TypeError(