@callimacus/thamyr-shopify 4.19.0 → 4.21.0

package/CHANGELOG.core.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [4.21.0](https://github.com/callimacus/thamyr-sdk/compare/thamyr-core-v4.20.0...thamyr-core-v4.21.0) (2026-11-03)
+
+
+### Features
+
+* **core,react,vanilla,shopify,liquid:** onWarning in every wrapper, and a logger switch for the no-code runtimes ([#885](https://github.com/callimacus/thamyr-sdk/issues/885)) ([0508523](https://github.com/callimacus/thamyr-sdk/commit/0508523d79b080c1bd7b5496b9bc6640f3f1a64b))
+
+## [4.20.0](https://github.com/callimacus/thamyr-sdk/compare/thamyr-core-v4.19.0...thamyr-core-v4.20.0) (2026-11-03)
+
+
+### Features
+
+* **shopify:** the chat's add keeps its reply, offers the option choice, and is one runner with thamyr-react ([#881](https://github.com/callimacus/thamyr-sdk/issues/881)) ([c99096c](https://github.com/callimacus/thamyr-sdk/commit/c99096c294a44a992e7d97f0d4726102df189fb7))
+
 ## [4.19.0](https://github.com/callimacus/thamyr-sdk/compare/thamyr-core-v4.18.0...thamyr-core-v4.19.0) (2026-11-03)
 
 

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [4.21.0](https://github.com/callimacus/thamyr-sdk/compare/thamyr-shopify-v4.20.0...thamyr-shopify-v4.21.0) (2026-11-03)
+
+
+### Features
+
+* **core,react,vanilla,shopify,liquid:** onWarning in every wrapper, and a logger switch for the no-code runtimes ([#885](https://github.com/callimacus/thamyr-sdk/issues/885)) ([0508523](https://github.com/callimacus/thamyr-sdk/commit/0508523d79b080c1bd7b5496b9bc6640f3f1a64b))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @callimacus/thamyr-core bumped from ^4.20.0 to ^4.21.0
+
+## [4.20.0](https://github.com/callimacus/thamyr-sdk/compare/thamyr-shopify-v4.19.0...thamyr-shopify-v4.20.0) (2026-11-03)
+
+
+### Features
+
+* **shopify:** the chat's add keeps its reply, offers the option choice, and is one runner with thamyr-react ([#881](https://github.com/callimacus/thamyr-sdk/issues/881)) ([c99096c](https://github.com/callimacus/thamyr-sdk/commit/c99096c294a44a992e7d97f0d4726102df189fb7))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @callimacus/thamyr-core bumped from ^4.19.0 to ^4.20.0
+
 ## [4.19.0](https://github.com/callimacus/thamyr-sdk/compare/thamyr-shopify-v4.18.0...thamyr-shopify-v4.19.0) (2026-11-03)
 
 

package/README.md

@@ -224,7 +224,7 @@ window.callimacusRenderers.push({
 
 | Member | What |
 |---|---|
-| `ctx.chapter` | `{id, index, isFirst, question, done, blocks}` (`blocks` is a frozen copy of the chapter's merged blocks) |
+| `ctx.chapter` | `{id, index, isFirst, question, done, blocks, addedToCart}` (`blocks` is a frozen copy of the chapter's merged blocks; `addedToCart` when the chat added to the bag in that round, so a reply that stands alone is no refusal) |
 | `ctx.final` | `ctx.chapter.done` |
 | `ctx.settings` | The global config |
 | `ctx.text(block)` | First non-empty string of `block.data` (direct or under `text`) |
@@ -234,7 +234,7 @@ window.callimacusRenderers.push({
 | `ctx.url(item)` | The storefront link under `rootUrl`: `products/<handle>`, `collections/<handle>`, `blogs/<blogHandle>/<handle>`, or a page's or policy's `meta.url`; `''` when it has none |
 | `ctx.imageUrl(hit, {width = 800, index = 0})` | Shopify CDN URL with `width`; falls back to image 0 |
 | `ctx.variantId(hit)` | Numeric id of the first orderable variant |
-| `ctx.addToCart(variantId, quantity = 1)` | The theme's cart where the kit knows it, else Shopify's cart API and our confirmation (see Cart). Rejects with a readable `Error` |
+| `ctx.addToCart(variantId, quantity = 1)` | The theme's cart where the kit knows it, else Shopify's cart API and our confirmation (see Cart). Rejects with a readable `Error`: a `CartAddError` whose `code` is `refused` (Shopify's own words), `cart_unavailable` (no cart answered) or `failed` |
 | `ctx.ask(question)` | Continue the thread with a follow-up; queued while a round is in flight |
 | `ctx.remember(kind, value)` | Personalisation memory (`questions`, `viewed`, `added`) |
 
@@ -307,6 +307,26 @@ Cart (`src/browser/embed/kit.ts`, `src/browser/cart.ts`):
 - **Any other theme**: `POST {cart_add_url}.js`, our confirmation (`.cal-toast`, "View cart"), and
   the header's cart link redrawn from a fresh copy of its section.
 
+The chat's adds to the bag (`src/browser/runtime/index.ts`, `src/browser/runtime/chat-cart.ts`):
+
+- Every round says the theme's cart runs here (`context.shopifyCart`), so the chat may answer
+  "add the black one in M to my bag" with a `cart-command`. On a product page, a round about that
+  product also carries it as an item on screen, so "this one" can mean it; once the shopper removes
+  the "About" chip it does not.
+- A command runs only for a Shopify variant, in this tab's story, at most once per round
+  (thamyr-core's cart runner, the rounds kept in sessionStorage), and at most 10 of it. It adds
+  through `ctx.addToCart`, so the theme's cart redraws as for a card's button.
+- What it came to is a line in the chapter that asked (`.cal-cart-notice`, `role="status"`,
+  `data-outcome` `added`, `refused`, `unavailable` or `failed`), below the reply. A chapter whose
+  add ran offers no "Ask again", which would add again, and its reply is never taken for a refusal
+  when it stands alone. Both, and the line, are kept with the thread, so the next page shows the
+  round as this one did. The embed reports no add to Callimacus.
+- The status line says the same for a few seconds, and `callimacus:cart` on `document` tells the theme
+  (`{outcome, variantId, quantity, message?}`, `message` when it was not added).
+- When the chat cannot tell which variant to add, it sends the option choice
+  (`custom:addToCartResult`): a button per variant with all its options, sold-out ones disabled;
+  a tap adds that variant and shows the same line. One add runs at a time.
+
 ### Page surface and events
 
 `window.callimacus = {ask, thread, ctx, timings, state, storyId, reset, style, embed}`: `style` is
@@ -348,6 +368,16 @@ cart. Events on `document`: `callimacus:ready` `{designMode, off}`, `callimacus:
 - Personalisation lives in `callimacus.memory`, kept as the thread is: questions, viewed and added
   products (12 each). The home welcome offers the last questions and "Recently viewed" cards.
 
+## Seeing the SDK's warnings
+
+The SDK's logger is off, so shoppers' consoles stay quiet. Open a storefront page with
+`?callimacus_debug` in its URL, or run `localStorage.setItem('callimacus:debug', '1')` in the
+console and reload, and the runtime turns the logger on at `warn` when it starts
+(`enableLoggerIfRequested` in core). A block a round did not show because one of its contents
+failed then logs `Block "saga" was not shown: its content "guide" failed (shortfall).` The reason
+stays server-side: `callimacus thamyr probe` shows it. `localStorage.removeItem('callimacus:debug')`
+turns it off again. Nothing in the theme changes.
+
 ## Styling
 
 `dist/browser/callimacus.css` is `src/browser/chrome.css` (dock, chapter frame, slots, skeletons,

package/dist/browser/callimacus.css

@@ -527,6 +527,15 @@ text-decoration: underline;
 text-underline-offset: 3px;
 cursor: pointer;
 }
+:is(html,#callimacus#callimacus) .cal-cart-notice {
+margin: 0;
+padding-block: 8px 16px;
+color: var(--cal-fg);
+font-size: 14px;
+}
+:is(html,#callimacus#callimacus) .cal-cart-notice:not([data-outcome='added']) {
+color: color-mix(in srgb, var(--cal-fg) 75%, transparent);
+}
 :is(html,#callimacus#callimacus) .cal-slot {
 min-width: 0;
 }
@@ -1164,6 +1173,35 @@ gap: 16px;
 :is(html,#callimacus#callimacus) .cal-next__title {
 margin: 0;
 }
+:is(html,#callimacus#callimacus) .cal-choice .cal-section__inner {
+display: grid;
+justify-items: start;
+gap: 12px;
+}
+:is(html,#callimacus#callimacus) .cal-choice__title {
+margin: 0;
+}
+:is(html,#callimacus#callimacus) .cal-choice__options {
+display: flex;
+flex-wrap: wrap;
+gap: 10px;
+}
+:is(html,#callimacus#callimacus) button.cal-choice__option {
+gap: 8px;
+min-width: 0;
+max-width: 100%;
+min-height: 44px;
+padding: 10px 18px;
+font-size: 14px;
+line-height: 1.3;
+}
+:is(html,#callimacus#callimacus) .cal-choice__sold-out {
+color: color-mix(in srgb, currentcolor 70%, transparent);
+font-size: 12px;
+}
+:is(html,#callimacus#callimacus) .cal-choice__status:empty {
+display: none;
+}
 :is(html,#callimacus#callimacus) .cal-redirect .cal-section__inner {
 gap: 24px;
 }