@rudra-js/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clive Dsouza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# @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.
+
+No client JavaScript. The recommendation area arrives in the initial HTML
+response and needs no hydration, which is what removes the pop-in of a
+client-fetched recommendation rail and what makes the content visible to a
+crawler that does not run JavaScript.
+
+## Install
+
+```sh
+npm install @rudra-js/react @rudra-js/core react zod@^4
+```
+
+Both `@rudra-js/core` and `react` are peer dependencies: the specification you pass
+in comes from your copy of core, and the elements this renders have to come from
+the same React your app renders. Two copies of either would mean a spec that
+fails its own type check, or a component tree React refuses to render.
+
+```tsx
+import { RudraComponent } from '@rudra-js/react';
+
+<RudraComponent spec={spec} products={catalog} locale="en-GB" />;
+```
+
+`spec` is what `createComponentGenerator().generate()` returned. `products` is
+your catalog.
+
+## What comes from where
+
+This split is the reason a generated component is safe to put in a page.
+
+| 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    |
+
+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
+reconciliation has already checked. Everything the model writes is rendered as
+text and escaped by React.
+
+**Validate `products` with `productSchema` from `@rudra-js/core`** — the same
+schema your candidates already passed. It is a second door into the framework:
+`imageUrl` lands in an `<img src>`, and `productSchema` is what rejects a
+protocol-relative `//evil.example/pixel.png` or a `data:` URL. React neutralises
+a `javascript:` URL by itself, but not those. A price that is not a finite
+number throws rather than rendering the product as free.
+
+## Styling
+
+The package ships no CSS, on purpose — a stylesheet would fight whatever your
+site already has. Unstyled, the block renders as a run-on line: every card
+element is inline, so titles and prices sit together with no separation. That is
+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.
+
+Every element it emits carries a class, and this is all of them:
+
+| Where          | Classes                                                                                                                                                                                                    |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| The wrapper    | `.rudra`, `.rudra__header`, `.rudra__headline`, `.rudra__subheadline`, `.rudra__rationale`                                                                                                                 |
+| A hero         | `.rudra-hero`, `.rudra-hero__headline`, `.rudra-hero__body`, `.rudra-hero__link`, `.rudra-hero__price`, `.rudra-hero__cta`                                                                                 |
+| A grid         | `.rudra-grid`, `.rudra-grid__title`, `.rudra-grid__items`                                                                                                                                                  |
+| A carousel     | `.rudra-carousel`, `.rudra-carousel__title`, `.rudra-carousel__track`                                                                                                                                      |
+| A banner       | `.rudra-banner`, `.rudra-banner__text`, `.rudra-banner__cta`                                                                                                                                               |
+| A copy block   | `.rudra-copy`, `.rudra-copy__title`, `.rudra-copy__body`                                                                                                                                                   |
+| A bundle       | `.rudra-bundle`, `.rudra-bundle__label`, `.rudra-bundle__title`, `.rudra-bundle__body`, `.rudra-bundle__items`, `.rudra-bundle__item`, `.rudra-bundle__link`, `.rudra-bundle__price`, `.rudra-bundle__cta` |
+| A product card | `.rudra-card`, `.rudra-card--featured`, `.rudra-card__image`, `.rudra-card__body`, `.rudra-card__title`, `.rudra-card__price`, `.rudra-card__reason`, `.rudra-card__badge`                                 |
+
+`.rudra__rationale` only appears under `hasDiagnostics`. `.rudra-bundle__label`
+is your own name for the set, and appears only for a bundle you gave a `label`.
+`className` is added alongside `rudra` rather than replacing it, so the child
+classes keep working.
+
+`.rudra-carousel__track` is expected to scroll horizontally — give it `overflow-x: auto`, since nothing here uses JavaScript to scroll it. `.rudra-card--featured` is applied alongside `.rudra-card`, so write it as `.rudra-card--featured { ... }` after the base
+rule rather than instead of it.
+
+### Attributes
+
+The same markup carries what the model decided, for styling and for analytics.
+
+| Attribute                | On                             | Value                                                      |
+| ------------------------ | ------------------------------ | ---------------------------------------------------------- |
+| `data-rudra-slot`        | the wrapper                    | The slot the spec was generated for                        |
+| `data-rudra-source`      | the wrapper                    | `llm`, `cache` or `fallback`                               |
+| `data-rudra-tone`        | the wrapper                    | The tone the model chose for the component                 |
+| `data-rudra-banner-tone` | a banner                       | A banner's own tone, a different vocabulary from the above |
+| `data-rudra-columns`     | a grid                         | The column count the model chose                           |
+| `data-rudra-sku`         | a card, hero link, bundle item | The product, for click attribution                         |
+| `data-rudra-basis`       | a card                         | Why the product was picked — `most_viewed`, `popular`, …   |
+
+`data-rudra-source` is public on purpose: hit rate and fallback share can be
+read straight off a rendered page. Everything more specific appears only under
+`hasDiagnostics`, since it tells a visitor what you run and when it is failing:
+
+| Attribute               | On          | Value                                                                                                                  |
+| ----------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `data-rudra-provider`   | the wrapper | The model vendor, or `none`                                                                                            |
+| `data-rudra-model`      | the wrapper | The model name, or `none`                                                                                              |
+| `data-rudra-latency-ms` | the wrapper | How long generation took                                                                                               |
+| `data-rudra-degraded`   | the wrapper | Why it fell back: `no-provider`, `provider-error`, `timeout`, `invalid-generation`, `unusable-on-serve` or `requested` |
+
+## Replacing a renderer
+
+Swap any block for your own design-system component. The model is not involved
+and the specification does not change, so this gives it no new ability — it can
+still only choose from the same fixed vocabulary.
+
+```tsx
+import { RudraComponent, extendRegistry } from '@rudra-js/react';
+
+const registry = extendRegistry({
+  grid: ({ block, context }) => <MyProductGrid items={block.items} context={context} />,
+});
+
+<RudraComponent spec={spec} products={catalog} registry={registry} />;
+```
+
+## Props
+
+| Prop                | Notes                                                                                                                                                                                         |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `spec`              | Required. From `@rudra-js/core`.                                                                                                                                                              |
+| `products`          | Required. A list of products, or anything keyed by SKU. See below, and the warning above.                                                                                                     |
+| `bundles`           | The sets your shop sells together. Only needed if a spec can carry a bundle block.                                                                                                            |
+| `registry`          | Replace some or all block renderers.                                                                                                                                                          |
+| `hrefForSku`        | Defaults to `/product/{sku}`, URL-encoded.                                                                                                                                                    |
+| `formatPrice`       | Defaults to `Intl.NumberFormat`, which knows each currency's own number of decimal places. It formats products, not bundles.                                                                  |
+| `formatBundlePrice` | The same for a bundle's own price, in the currency the shop put on the set. The set's price and its currency come from the same object, so members priced in another currency change nothing. |
+| `locale`            | Punctuates prices. Defaults to the **server's** locale, which is rarely the shopper's — pass it if you serve more than one.                                                                   |
+| `hasDiagnostics`    | Adds the provider, the model name, the latency and the model's own reasoning to the markup. Off by default: it tells a visitor which model you use and when it is failing.                    |
+| `className`         | Added alongside `rudra`.                                                                                                                                                                      |
+
+### What `products` may be
+
+A list of products, or anything keyed by SKU that answers `get(sku)` and
+`has(sku)` — a `Map`, or your own index. Those two methods are the only ones the
+renderers call, so a shop with a catalog too large to copy into a `Map` on every
+request can pass a view over its own store instead.
+
+The check is on those two methods rather than on `instanceof Map`, which is
+per-realm: a `Map` arriving from a worker or a `node:vm` sandbox is a perfectly
+good catalog and fails `instanceof`. Anything that is neither a list nor keyed —
+a `Set` of products, a plain object, a `Map` that has been through JSON — is
+refused on the spot with an error naming the prop, rather than quietly rendering
+an empty recommendation area.
+
+The component renders nothing at all when there is nothing to show — a spec with
+no blocks, or one whose every product has left your catalog since it was
+generated. An empty recommendation area, or a headline over an empty box, takes
+up space and tells the shopper the page is broken.
+
+### What `bundles` is
+
+The sets your shop sells together, the same way `products` is your catalog. The
+model only asks for a bundle block; it never invents one, and it never sees a
+price.
+
+You offer the sets, and the framework picks which one fills each block. It
+picks when the page is served — after the spec was generated, not before —
+inside `reconcileSpec`, from what this shopper has in their basket, has looked
+at, or is browsing now. The spec then carries the id it picked, and this prop
+supplies that set's members, its price, the currency that price is in and your
+name for it so the component can draw it.
+
+**Validate `bundles` with `bundleSchema` from `@rudra-js/core`, and pass the
+same list you sent to `parseTrackingInput`.** Core checked that list — every
+member in stock, none of them disliked, no repeats, and the whole set inside
+the item budget — and then hands the renderer nothing but the id it chose. A
+stale or different list here draws a set none of those checks ever saw, under
+an id that was proved against another one.
+
+## Licence
+
+[MIT](./LICENSE)

package/dist/blocks/block-renderers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Five of the six block renderers. The bundle one lives in `bundle-block.tsx`,
+ * next door, since it draws a set the shop picked rather than the model.
+ *
+ * Each takes a block the model produced and a context the host owns. None of
+ * them interpolate markup, and none of them read a product fact from the block
+ * — that is what keeps generated output to the role of deciding layout, order
+ * and wording.
+ */
+import type { BannerBlock, CarouselBlock, CopyBlock, GridBlock, HeroBlock } from '@rudra-js/core';
+import type { BlockRenderContext } from '../render-context.js';
+export declare function HeroRenderer({ block, context, }: {
+    block: HeroBlock;
+    context: BlockRenderContext;
+}): import("react").JSX.Element;
+export declare function GridRenderer({ block, context, }: {
+    block: GridBlock;
+    context: BlockRenderContext;
+}): import("react").JSX.Element;
+export declare function CarouselRenderer({ block, context, }: {
+    block: CarouselBlock;
+    context: BlockRenderContext;
+}): import("react").JSX.Element;
+export declare function BannerRenderer({ block }: {
+    block: BannerBlock;
+}): import("react").JSX.Element;
+export declare function CopyRenderer({ block }: {
+    block: CopyBlock;
+}): import("react").JSX.Element;
+//# sourceMappingURL=block-renderers.d.ts.map

package/dist/blocks/block-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-renderers.d.ts","sourceRoot":"","sources":["../../src/blocks/block-renderers.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,+BAuBA;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,+BAWA;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,+BAaA;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,+BAO/D;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,+BAO3D"}

package/dist/blocks/block-renderers.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ProductCard } from './product-card.js';
+export function HeroRenderer({ block, context, }) {
+    const product = block.sku ? context.products.get(block.sku) : undefined;
+    return (_jsxs("section", { className: "rudra-hero", children: [_jsx("h3", { className: "rudra-hero__headline", children: block.headline }), block.body ? _jsx("p", { className: "rudra-hero__body", children: block.body }) : null, product ? (_jsxs("a", { className: "rudra-hero__link", href: context.hrefForSku(product.sku), "data-rudra-sku": product.sku, children: [product.title, _jsx("span", { className: "rudra-hero__price", children: context.formatPrice(product) })] })) : null, product && block.ctaLabel ? _jsx("span", { className: "rudra-hero__cta", children: block.ctaLabel }) : null] }));
+}
+export function GridRenderer({ block, context, }) {
+    return (_jsxs("section", { className: "rudra-grid", "data-rudra-columns": block.columns, children: [block.title ? _jsx("h3", { className: "rudra-grid__title", children: block.title }) : null, _jsx("div", { className: "rudra-grid__items", children: block.items.map((reference) => (_jsx(ProductCard, { reference: reference, context: context }, reference.sku))) })] }));
+}
+export function CarouselRenderer({ block, context, }) {
+    return (_jsxs("section", { className: "rudra-carousel", children: [block.title ? _jsx("h3", { className: "rudra-carousel__title", children: block.title }) : null, _jsx("div", { className: "rudra-carousel__track", children: block.items.map((reference) => (_jsx(ProductCard, { reference: reference, context: context }, reference.sku))) })] }));
+}
+export function BannerRenderer({ block }) {
+    return (_jsxs("aside", { className: "rudra-banner", "data-rudra-banner-tone": block.tone, children: [_jsx("span", { className: "rudra-banner__text", children: block.text }), block.ctaLabel ? _jsx("span", { className: "rudra-banner__cta", children: block.ctaLabel }) : null] }));
+}
+export function CopyRenderer({ block }) {
+    return (_jsxs("section", { className: "rudra-copy", children: [block.title ? _jsx("h3", { className: "rudra-copy__title", children: block.title }) : null, _jsx("p", { className: "rudra-copy__body", children: block.body })] }));
+}
+//# sourceMappingURL=block-renderers.js.map

package/dist/blocks/block-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-renderers.js","sourceRoot":"","sources":["../../src/blocks/block-renderers.tsx"],"names":[],"mappings":"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"}

package/dist/blocks/bundle-block.d.ts

@@ -0,0 +1,7 @@
+import type { BundleBlock } from '@rudra-js/core';
+import type { BlockRenderContext } from '../render-context.js';
+export declare function BundleRenderer({ block, context, }: {
+    block: BundleBlock;
+    context: BlockRenderContext;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=bundle-block.d.ts.map

package/dist/blocks/bundle-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-block.d.ts","sourceRoot":"","sources":["../../src/blocks/bundle-block.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,sCAiCA"}

package/dist/blocks/bundle-block.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function BundleRenderer({ block, context, }) {
+    const bundle = block.bundleId === null ? undefined : context.bundles.get(block.bundleId);
+    if (!bundle)
+        return null;
+    const products = [];
+    for (const sku of bundle.skus) {
+        const product = context.products.get(sku);
+        // A set missing one of its parts is not that set.
+        if (!product)
+            return null;
+        products.push(product);
+    }
+    return (_jsxs("section", { className: "rudra-bundle", children: [bundle.label ? _jsx("h3", { className: "rudra-bundle__label", children: bundle.label }) : null, block.title ? _jsx("p", { className: "rudra-bundle__title", children: block.title }) : null, block.body ? _jsx("p", { className: "rudra-bundle__body", children: block.body }) : null, _jsx("ul", { className: "rudra-bundle__items", children: products.map((product) => (_jsx("li", { className: "rudra-bundle__item", "data-rudra-sku": product.sku, children: _jsx("a", { className: "rudra-bundle__link", href: context.hrefForSku(product.sku), children: product.title }) }, product.sku))) }), _jsx("p", { className: "rudra-bundle__price", children: context.formatBundlePrice(bundle) }), block.ctaLabel ? _jsx("span", { className: "rudra-bundle__cta", children: block.ctaLabel }) : null] }));
+}
+//# sourceMappingURL=bundle-block.js.map

package/dist/blocks/bundle-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-block.js","sourceRoot":"","sources":["../../src/blocks/bundle-block.tsx"],"names":[],"mappings":";AAGA,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,OAAO,GAIR;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,kDAAkD;QAClD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,CACL,mBAAS,SAAS,EAAC,cAAc,aAE9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAI,SAAS,EAAC,qBAAqB,YAAE,MAAM,CAAC,KAAK,GAAM,CAAC,CAAC,CAAC,IAAI,EAC7E,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,YAAG,SAAS,EAAC,qBAAqB,YAAE,KAAK,CAAC,KAAK,GAAK,CAAC,CAAC,CAAC,IAAI,EACzE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAG,SAAS,EAAC,oBAAoB,YAAE,KAAK,CAAC,IAAI,GAAK,CAAC,CAAC,CAAC,IAAI,EAEvE,aAAI,SAAS,EAAC,qBAAqB,YAChC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACzB,aAAsB,SAAS,EAAC,oBAAoB,oBAAiB,OAAO,CAAC,GAAG,YAC9E,YAAG,SAAS,EAAC,oBAAoB,EAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,YACpE,OAAO,CAAC,KAAK,GACZ,IAHG,OAAO,CAAC,GAAG,CAIf,CACN,CAAC,GACC,EAEL,YAAG,SAAS,EAAC,qBAAqB,YAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAK,EACzE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,mBAAmB,YAAE,KAAK,CAAC,QAAQ,GAAQ,CAAC,CAAC,CAAC,IAAI,IAC5E,CACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ProductReference } from '@rudra-js/core';
+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.
+ */
+export declare function ProductCard({ reference, context, }: {
+    reference: ProductReference;
+    context: BlockRenderContext;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=product-card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product-card.d.ts","sourceRoot":"","sources":["../../src/blocks/product-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,OAAO,GACR,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,kBAAkB,CAAC;CAC7B,sCA2BA"}

package/dist/blocks/product-card.js

@@ -0,0 +1,19 @@
+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.
+ */
+export function ProductCard({ reference, context, }) {
+    const product = context.products.get(reference.sku);
+    // Reconciliation drops a SKU the catalog does not have, so this should be
+    // unreachable. Rendering nothing beats rendering a card with holes in it.
+    if (!product)
+        return null;
+    const isFeatured = reference.emphasis === 'featured';
+    return (_jsxs("a", { href: context.hrefForSku(product.sku), "data-rudra-sku": product.sku, "data-rudra-basis": reference.basis, className: isFeatured ? 'rudra-card rudra-card--featured' : 'rudra-card', children: [product.imageUrl ? (_jsx("img", { className: "rudra-card__image", src: product.imageUrl, alt: "", loading: "lazy" })) : null, _jsxs("span", { className: "rudra-card__body", children: [reference.badge ? _jsx("span", { className: "rudra-card__badge", children: reference.badge }) : null, _jsx("span", { className: "rudra-card__title", children: product.title }), _jsx("span", { className: "rudra-card__price", children: context.formatPrice(product) }), reference.reason ? _jsx("span", { className: "rudra-card__reason", children: reference.reason }) : null] })] }));
+}
+//# sourceMappingURL=product-card.js.map

package/dist/blocks/product-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-card.js","sourceRoot":"","sources":["../../src/blocks/product-card.tsx"],"names":[],"mappings":";AAGA;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,OAAO,GAIR;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpD,0EAA0E;IAC1E,0EAA0E;IAC1E,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,KAAK,UAAU,CAAC;IAErD,OAAO,CACL,aACE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,oBACrB,OAAO,CAAC,GAAG,sBACT,SAAS,CAAC,KAAK,EACjC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,YAAY,aAEvE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAClB,cAAK,SAAS,EAAC,mBAAmB,EAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAC,EAAE,EAAC,OAAO,EAAC,MAAM,GAAG,CACnF,CAAC,CAAC,CAAC,IAAI,EAER,gBAAM,SAAS,EAAC,kBAAkB,aAC/B,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,mBAAmB,YAAE,SAAS,CAAC,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,EACtF,eAAM,SAAS,EAAC,mBAAmB,YAAE,OAAO,CAAC,KAAK,GAAQ,EAC1D,eAAM,SAAS,EAAC,mBAAmB,YAAE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAQ,EACxE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,oBAAoB,YAAE,SAAS,CAAC,MAAM,GAAQ,CAAC,CAAC,CAAC,IAAI,IACpF,IACL,CACL,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @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';
+export { ProductCard } from './blocks/product-card.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @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

@@ -0,0 +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"}

package/dist/registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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';
+export type BlockRenderer<Kind extends BlockKind> = (props: {
+    block: Extract<Block, {
+        kind: Kind;
+    }>;
+    context: BlockRenderContext;
+}) => ReactNode;
+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

@@ -0,0 +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"}

package/dist/registry.js

@@ -0,0 +1,39 @@
+/**
+ * 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 = {
+    hero: HeroRenderer,
+    grid: GridRenderer,
+    carousel: CarouselRenderer,
+    banner: BannerRenderer,
+    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,
+        grid: overrides.grid ?? defaultRegistry.grid,
+        carousel: overrides.carousel ?? defaultRegistry.carousel,
+        banner: overrides.banner ?? defaultRegistry.banner,
+        copy: overrides.copy ?? defaultRegistry.copy,
+        bundle: overrides.bundle ?? defaultRegistry.bundle,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +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"}

package/dist/render-context.d.ts

@@ -0,0 +1,46 @@
+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 what to show and how to describe it, 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;
+/**
+ * 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

@@ -0,0 +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;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA8B5E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBhF"}

package/dist/render-context.js

@@ -0,0 +1,68 @@
+export function defaultHrefForSku(sku) {
+    return `/product/${encodeURIComponent(sku)}`;
+}
+/**
+ * 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) {
+    // A price that is not a finite number is a broken catalog, not a formatting
+    // problem, and Intl will happily render it: null becomes 0 and prints as a
+    // free product, undefined prints as NaN. Neither belongs on a shop page, and
+    // both mean the catalog skipped the validation this package documents as a
+    // precondition. Failing here is a bug report; rendering it is an incident.
+    if (!Number.isFinite(product.price)) {
+        throw new TypeError(`price for SKU ${product.sku} is ${String(product.price)}, not a finite number — ` +
+            'catalog objects must satisfy productSchema from @rudra-js/core');
+    }
+    let formatter;
+    try {
+        // Only the constructor is guarded. Wrapping format() as well would swallow
+        // a throwing getter on a host's own Product object and render the resulting
+        // mess as a price.
+        formatter = new Intl.NumberFormat(locale, { style: 'currency', currency: product.currency });
+    }
+    catch {
+        // Two things reach this. A malformed `locale`, which is a host prop nothing
+        // validates. And a malformed `currency` — which productSchema would have
+        // rejected, but this package takes a catalog directly, so a hand-built
+        // object can carry one. Intl accepts any three-letter code it does not
+        // know, so 'ZZZ' formats; 'us$' and '' do not. A price nobody can
+        // punctuate is still a price worth showing.
+        return `${product.currency} ${product.price}`;
+    }
+    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 — ` +
+            'bundle objects must satisfy bundleSchema from @rudra-js/core');
+    }
+    try {
+        return new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency: bundle.currency,
+        }).format(bundle.price);
+    }
+    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}`;
+    }
+}
+//# sourceMappingURL=render-context.js.map

package/dist/render-context.js.map

@@ -0,0 +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"}