create-ailk 0.5.0 → 0.6.1

package/templates/apps/web/messages/en.json

@@ -49,6 +49,10 @@
     "emptyState": "No documentation yet. Add MDX files to",
     "emptyStateTrailing": "to populate this list."
   },
+  "cancellation": {
+    "heading": "Cancellation Policy",
+    "emptyState": "Cancellation policy content coming soon."
+  },
   "careers": {
     "heading": "Careers",
     "emptyState": "Career listings coming soon."
@@ -214,10 +218,39 @@
     "heading": "Projects",
     "emptyState": "Projects listing coming soon."
   },
+  "purchase": {
+    "success": {
+      "title": "Payment successful",
+      "message": "Thanks for your order — here's what you bought.",
+      "statusLabel": "Paid",
+      "sessionIdLabel": "Order",
+      "lineItem": "Qty {quantity} · {amount}",
+      "continueLabel": "Back to services",
+      "pendingHeadline": "We have your order",
+      "pendingBody": "Payment is still settling. This page will not update on its own — check your email for the receipt, or come back in a few minutes.",
+      "unknownHeadline": "We can't look up this order from here",
+      "unknownBody": "Check your email for the receipt from checkout — it has everything about your order.",
+      "ctaHeadline": "Keep going",
+      "ctaDescription": "Have a look at what else we offer.",
+      "ctaLabel": "Browse services"
+    },
+    "cancel": {
+      "title": "Checkout canceled",
+      "message": "Nothing was charged. Your card was not billed.",
+      "statusLabel": "Canceled",
+      "ctaHeadline": "Still interested?",
+      "ctaDescription": "Head back to the service menu whenever you're ready.",
+      "ctaLabel": "Back to services"
+    }
+  },
   "resources": {
     "heading": "Resources",
     "emptyState": "Resources listing coming soon."
   },
+  "returns": {
+    "heading": "Returns & Refunds",
+    "emptyState": "Returns and refunds content coming soon."
+  },
   "schedule": {
     "title": "Book a call",
     "description": "Pick a time that works for you.",
@@ -240,6 +273,10 @@
     "heading": "Services",
     "emptyState": "Services listing coming soon."
   },
+  "shipping": {
+    "heading": "Shipping Policy",
+    "emptyState": "Shipping policy content coming soon."
+  },
   "software": {
     "heading": "Software",
     "description": "The @working-theory/* packages \u2014 typed tools for building AX-first products.",
@@ -396,6 +433,64 @@
     "signInFailed": "We couldn't sign you in. Check your details and try again.",
     "providerFailed": "We couldn't start sign-in with that provider. Try again."
   },
+  "auth": {
+    "signUpTitle": "Create an account",
+    "signUpDescription": "Create an account on this site.",
+    "forgotTitle": "Reset your password",
+    "forgotDescription": "Request a password reset link.",
+    "resetTitle": "Choose a new password",
+    "resetDescription": "Set a new password for your account.",
+    "verifyEmailTitle": "Check your email",
+    "verifyEmailDescription": "Follow the link we sent to continue.",
+    "email": "Email address",
+    "password": "Password",
+    "confirmPassword": "Confirm password",
+    "newPassword": "New password",
+    "orContinue": "Or continue with",
+    "ssoPrefix": "Continue with",
+    "google": "Google",
+    "github": "GitHub",
+    "backToSignIn": "Back to sign in",
+    "signUpHeading": "Create your account",
+    "signUpSubhead": "Enter your details to get started.",
+    "signUpSubmit": "Create account",
+    "signUpFooterPrompt": "Already have an account?",
+    "signUpFooterLink": "Sign in",
+    "signUpNotConfiguredSubhead": "Sign-up is not configured for this site yet. Set a provider's environment variables to enable it.",
+    "signUpFailed": "We couldn't create your account. Check your details and try again.",
+    "providerFailed": "We couldn't start sign-up with that provider. Try again.",
+    "invitationHeading": "Accounts are by invitation",
+    "invitationSubhead": "This site does not offer public sign-up.",
+    "invitationBody": "If you were invited, open the link in your invitation email to create your account.",
+    "forgotHeading": "Reset your password",
+    "forgotSubhead": "Enter your email and we will send a reset link.",
+    "forgotSubmit": "Send reset link",
+    "resetHeading": "Choose a new password",
+    "resetSubhead": "Choose a new password for your account.",
+    "resetSubmit": "Set new password",
+    "forgotUnavailableHeading": "Password reset isn't available",
+    "forgotUnavailableSubhead": "This site does not offer password reset.",
+    "forgotUnavailableBody": "Sign in with one of the providers on the sign-in page, or ask the site owner for help getting back in.",
+    "resetUnavailableHeading": "Password reset isn't available",
+    "resetUnavailableSubhead": "This reset link cannot be used on this site.",
+    "resetUnavailableBody": "Password reset is not enabled here. Sign in with one of the providers on the sign-in page instead.",
+    "sentToPrefix": "We sent it to",
+    "resetRequestFailed": "We couldn't send a reset link just now. Try again in a few minutes.",
+    "resetFailed": "We couldn't set that password. The link may have expired \u2014 request a new one.",
+    "passwordMismatch": "Both passwords must match.",
+    "resetExpiredHeading": "This reset link has expired",
+    "resetExpiredSubhead": "Reset links are single-use and last one hour.",
+    "resetExpiredBody": "Request a new link from the sign-in page and follow the most recent email.",
+    "verifyExpiredHeading": "This confirmation link has expired",
+    "verifyExpiredSubhead": "Confirmation links last 24 hours.",
+    "verifyExpiredBody": "Sign in again and we'll send you a fresh confirmation email.",
+    "sentHeading": "Check your email",
+    "sentSubhead": "Follow the link we just sent to continue.",
+    "sentBody": "Check your inbox and follow the link to continue. You can close this tab once you're done.",
+    "footerPrivacy": "Privacy",
+    "footerTerms": "Terms",
+    "footerHelp": "Help"
+  },
   "account": {
     "title": "Your account",
     "description": "Your profile, results, and purchases.",
@@ -433,6 +528,12 @@
       "date": "Date",
       "emptyHeadline": "No purchases yet",
       "emptyDescription": "Purchases you complete will appear here."
+    },
+    "subscription": {
+      "headline": "Your payment didn't go through",
+      "descriptionPastDue": "Update your card to keep your subscription active.",
+      "descriptionCanceled": "Your subscription was canceled. Update your card by {date} to keep your access.",
+      "action": "Update payment method"
     }
   },
   "admin": {
@@ -480,5 +581,91 @@
       "emptyHeadline": "No members yet",
       "emptyDescription": "People with access to this workspace will appear here."
     }
+  },
+  "edit": {
+    "title": "Pages",
+    "description": "Edit your site's pages and publish changes without a deploy.",
+    "listHeading": "Pages",
+    "listDescription": "Every page on this site. Choose one to edit its content and publish your changes.",
+    "listEmptyHeadline": "No pages yet",
+    "listEmptyDescription": "Pages you create appear here, ready to edit and publish.",
+    "statusDraft": "Draft",
+    "statusPublished": "Published",
+    "statusPublishedWithDraft": "Published, with unpublished changes",
+    "licenceRequiredHeadline": "Content editing is a Pro feature",
+    "licenceRequiredDescription": "Editing pages without a deploy is part of Pro. Add a Pro licence to this site to turn it on.",
+    "notFoundHeadline": "Page not found",
+    "notFoundDescription": "There is no page at this address. It may have been renamed or removed.",
+    "editor": {
+      "tabForm": "Details",
+      "tabBody": "Body",
+      "tabPreview": "Preview",
+      "tabCode": "Code",
+      "statusDraft": "Draft",
+      "statusNotYetLive": "Not yet live",
+      "statusPublished": "Published",
+      "frontmatterHeading": "Page details",
+      "frontmatterTitle": "Title",
+      "frontmatterSlug": "Slug",
+      "frontmatterDescription": "Description",
+      "issuesHeading": "Fix these before publishing",
+      "saveButton": "Save draft",
+      "saving": "Saving\u2026",
+      "saved": "Saved",
+      "saveError": "Could not save. Try again.",
+      "publishButton": "Publish",
+      "publishing": "Publishing\u2026",
+      "published": "Published",
+      "publishError": "Could not publish. Try again.",
+      "unpublishButton": "Unpublish",
+      "unpublishing": "Unpublishing\u2026",
+      "unpublished": "Unpublished",
+      "unpublishError": "Could not unpublish. Try again.",
+      "conflictHeading": "Someone else saved this page",
+      "conflictMessage": "This page changed since you opened it. Reload to take their version, or overwrite it with yours.",
+      "conflictReload": "Reload their version",
+      "conflictOverwrite": "Overwrite with mine",
+      "imageInsertLabel": "Insert an image",
+      "imageInsertHint": "The image is uploaded and its markdown inserted at the cursor.",
+      "imageAlt": "Image",
+      "imageInsertError": "Could not upload that image. Try again.",
+      "codeHeading": "Composed MDX",
+      "diffLegendAdded": "Added",
+      "diffLegendRemoved": "Removed",
+      "diffLegendUnchanged": "Unchanged"
+    },
+    "sections": {
+      "heading": "Sections",
+      "arrayAdd": "Add",
+      "arrayRemove": "Remove",
+      "unsupportedField": "This field is edited as raw JSON",
+      "sectionLevelErrors": "Other problems with this section"
+    },
+    "body": {
+      "label": "Body",
+      "hint": "Markdown. Headings, links, lists and images all work.",
+      "machinePreambleNotice": "This page starts with imports or components. They are preserved and are not editable here."
+    }
+  },
+  "appointments": {
+    "title": "Appointments",
+    "description": "Your site's upcoming bookings, soonest first.",
+    "forbiddenHeadline": "You don't have access",
+    "forbiddenDescription": "Sign in with the account that owns this site to see its bookings.",
+    "table": {
+      "caption": "Upcoming bookings for your site",
+      "columnWhen": "When",
+      "columnWho": "Who",
+      "columnStatus": "Status",
+      "columnPaid": "Paid",
+      "statusPending": "Pending",
+      "statusConfirmed": "Confirmed",
+      "statusCancelled": "Cancelled",
+      "paidYes": "Paid",
+      "paidNo": "Unpaid",
+      "next": "Next page",
+      "emptyHeadline": "No upcoming bookings",
+      "emptyDescription": "When someone books a time with you, the appointment appears here automatically."
+    }
   }
 }

package/templates/apps/web/middleware.ts

@@ -79,7 +79,7 @@ export function middleware(request: NextRequest): NextResponse {
 // The trailing `.*\\..*` alternative excludes any path whose last segment
 // contains a dot, i.e. every file with an extension. Without it the negative
 // lookahead named only favicon.ico, so next-intl's locale rewrite swallowed
-// every OTHER public/ asset — logo-light.svg, logo-dark.svg, site.webmanifest,
+// every OTHER public/ asset — logomark.svg, wordmark.svg, site.webmanifest,
 // og-default.png — and each 404'd (#4090 item 4). robots.txt and sitemap.xml are
 // route handlers rather than public/ files, but they carry extensions too and
 // are equally not locale-scoped, so the same rule covers them.

package/templates/apps/web/package.json

@@ -21,7 +21,9 @@
     "@working-theory/api-client": "workspace:*",
     "@working-theory/content-adapters": "workspace:*",
     "@working-theory/database": "workspace:*",
+    "@working-theory/ids": "workspace:*",
     "@working-theory/jsonld": "workspace:*",
+    "@working-theory/license": "workspace:*",
     "@working-theory/metadata": "workspace:*",
     "@working-theory/page-renderer": "workspace:*",
     "@working-theory/schema": "workspace:*",
@@ -64,7 +66,6 @@
     "@eslint/js": "^10.0.1",
     "globals": "^17.7.0",
     "typescript-eslint": "^8.62.1",
-    "@working-theory/license": "workspace:*",
     "@working-theory/sections-registry": "workspace:*"
   }
 }

package/templates/apps/web/src/lib/commerce-claim.ts

@@ -0,0 +1,33 @@
+/**
+ * The deployment's `commerce` add-on claim, resolved PER REQUEST (#6084 D12).
+ *
+ * Extracted from `app/.well-known/mcp.json/route.ts`'s own inline
+ * `resolveCommerceClaim()` (#5971) — that route's behaviour is unchanged;
+ * only its import line moves. `/purchase/success` and `/purchase/cancel`
+ * need the identical check (D12's shape-2 gate: the pages ship BASE TREE
+ * and gate at REQUEST time on this claim, exactly as the checkout
+ * primitives do — `apps/api/src/lib/require-commerce-claim.ts`), so this is
+ * extracted ONCE and imported three times rather than copied a third time.
+ *
+ * Fail-closed (NFR-3 mirror): anything short of a positively-held,
+ * unrevoked claim reads as absent, and a licence read that throws never
+ * takes the caller down with it. Called PER REQUEST rather than memoised —
+ * unlike `apps/mcp/src/lib/commerce-claim.ts`'s boot-time memoisation — so a
+ * site that buys commerce after its last deploy starts serving immediately
+ * rather than waiting on a redeploy.
+ */
+import { checkLicense } from "@working-theory/license";
+
+/** The licence `features[]` claim that turns the commerce add-on on. */
+const COMMERCE_FEATURE = "commerce";
+
+export async function resolveCommerceClaim(): Promise<boolean> {
+  try {
+    const result = await checkLicense();
+    return (
+      result.revoked !== true && result.features.includes(COMMERCE_FEATURE)
+    );
+  } catch {
+    return false;
+  }
+}

package/templates/apps/web/src/lib/commerce-sections.ts

@@ -0,0 +1,93 @@
+/**
+ * Lazily registers the paid `@working-theory/ui-commerce` slice's sections
+ * (`payment-receipt`) — never a static top-level import (#6084, code-review
+ * finding on this issue's PR).
+ *
+ * `/purchase/success` and `/purchase/cancel` ship in the BASE TREE
+ * (`surfaces.ts` `CORE_ROUTE_DIRS`, D12) so a site that buys the `commerce`
+ * add-on after its last deploy gets working return pages without a
+ * redeploy. But a KEYLESS scaffold carries NO `ui-commerce` dependency by
+ * design — `packages/create-ailk/scripts/build-templates.mjs`'s
+ * `transformPaidUiPackages()` strips it from a keyless `apps/web/package.json`,
+ * and `__tests__/paid-module-honest-states.test.ts`'s "#5581 U6" suite
+ * asserts a keyless scaffold declares NONE of the four paid `ui-*` packages
+ * as a dependency. A plain top-level, STATIC named-import of that package's
+ * `registerCommerceSections` export would leave every keyless customer's
+ * build failing with `ERR_MODULE_NOT_FOUND` — webpack resolves a static
+ * import at BUILD time regardless of whether the code path importing it
+ * ever executes at runtime, so gating the CALL at request time (as
+ * `resolveCommerceClaim()` already does) is not enough on its own.
+ *
+ * The `webpackIgnore` magic comment tells webpack to leave this `import()`
+ * unresolved at build time; Node's own ESM loader then attempts it at
+ * RUNTIME, where a keyless deployment's absent package throws a genuine
+ * (caught) resolution error instead of a build failure. This repo's `dev`
+ * and `build` scripts both force `--webpack` (never Turbopack, which does
+ * not honor this comment), so the magic comment is reliably honored here.
+ *
+ * On success, the real `payment-receipt` renderer is registered and the
+ * caller may build a `payment-receipt` section as usual. On failure (the
+ * package genuinely is not installed), the caller MUST NOT construct a bare
+ * `payment-receipt` section anyway — `SectionRenderer`'s dispatch table
+ * falls back to `ModuleAbsent`, which renders `null` in production
+ * (`packages/ui/src/sections/ModuleAbsent.tsx`) — silently dropping the
+ * title/message/status that is this page's entire point. The caller must
+ * build an OSS `content-block` fallback carrying the same copy instead.
+ *
+ * Registered (or found absent) once per process — memoised, so a concurrent
+ * request never double-registers or double-attempts a failed resolution.
+ * This is a build-presence fact, not the license claim itself (which
+ * `resolveCommerceClaim()` deliberately re-checks every request); a
+ * process only changes which packages are on disk via a fresh deploy, which
+ * is a fresh process.
+ */
+let registration: Promise<boolean> | undefined;
+
+/**
+ * The paid package's specifier, held in a CONST rather than written inline at
+ * the `import()` call (#6440 AC2).
+ *
+ * `webpackIgnore` defers only WEBPACK's resolution; `tsc` resolves a dynamic
+ * `import()` whose argument is a string LITERAL exactly as eagerly as a static
+ * one, so the literal form failed a keyless scaffold's type-check with TS2307
+ * "Cannot find module '@working-theory/ui-commerce'" — the build error #6440
+ * was filed for. This monorepo never saw it: `packages-paid/ui-commerce` is on
+ * disk here and `apps/web/package.json` declares it `workspace:*`, so the
+ * specifier resolves and the defect is reachable only from a scaffold.
+ *
+ * A non-literal specifier is the whole fix. `tsc` does not attempt module
+ * resolution on an `import()` it cannot constant-fold, so the paid package's
+ * ABSENCE stops being a type error — while webpack still honours the magic
+ * comment beside it and Node still performs the real resolution at runtime,
+ * leaving the `catch` below as the one and only thing that observes whether
+ * the package is installed. The behaviour is unchanged in both directions:
+ * a licensed deployment registers the sections; a keyless one returns false.
+ *
+ * The file deliberately stays in the BASE TREE rather than moving into the
+ * commerce slice: `/purchase/success` and `/purchase/cancel` import it
+ * statically, so slicing it out would take the return pages with it and
+ * regress #6084 D12 (disposed again on #6440, 2026-09-22).
+ */
+const COMMERCE_UI_PACKAGE = "@working-theory/ui-commerce";
+
+/** The one export this module needs from the paid package. */
+interface CommerceSectionsModule {
+  registerCommerceSections: () => void;
+}
+
+export function ensureCommerceSectionsRegistered(): Promise<boolean> {
+  if (!registration) {
+    registration = (async () => {
+      try {
+        const mod = (await import(
+          /* webpackIgnore: true */ COMMERCE_UI_PACKAGE
+        )) as CommerceSectionsModule;
+        mod.registerCommerceSections();
+        return true;
+      } catch {
+        return false;
+      }
+    })();
+  }
+  return registration;
+}

package/templates/content/_site.mdx

@@ -17,10 +17,25 @@ analytics:
 theme:
   colors:
     light:
-      bg: "#fdfcfa"
-      text: "#1c1917"
+      bg: "#ffffff"
+      bgMuted: "#ffffff"
+      surface: "#ffffff"
+      border: "#000000"
+      text: "#000000"
+      textMuted: "#333333"
+      primary: "#000000"
+      primaryFg: "#ffffff"
+      accent: "#000000"
     dark:
-      bg: "#0c0a09"
+      bg: "#000000"
+      bgMuted: "#000000"
+      surface: "#000000"
+      border: "#ffffff"
+      text: "#ffffff"
+      textMuted: "#cccccc"
+      primary: "#ffffff"
+      primaryFg: "#000000"
+      accent: "#ffffff"
 ---
 
 <!--

package/templates/content/en/CancellationPolicyPage/cancellation.mdx

@@ -0,0 +1,108 @@
+---
+type: "CancellationPolicyPage"
+slug: "cancellation"
+title: "Cancellation Policy"
+description: "How to cancel or reschedule a booking on this site, the notice required, and what a late cancellation or no-show costs."
+updatedAt: "2026-09-17"
+sections:
+  [
+    {
+      "id": "cancellation-document",
+      "type": "document-chassis",
+      "data":
+        {
+          "headline": "Cancellation Policy",
+          "backHref": "/",
+          "backLabel": "Back home",
+          "navGroupLabel": "Contents",
+          "stats":
+            [
+              { "label": "Last updated", "sublabel": "17 September 2026" },
+              { "label": "Applies to", "sublabel": "Bookings made on this site" },
+            ],
+          "sections":
+            [
+              {
+                "id": "intro",
+                "heading": "Cancellation Policy",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "This page explains how cancellations and reschedules work for bookings made on this site. Replace the starter copy below with the policy you actually operate — the headings are the ones a customer and an agent both look for, so keep them and fill in your own terms.",
+                    },
+                  ],
+              },
+              {
+                "id": "notice",
+                "heading": "How much notice is required",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "State the notice period in hours before the appointment, and say how it is measured. A customer reading at midnight should be able to work out, without arithmetic you have not shown them, whether they are still inside it.",
+                    },
+                  ],
+              },
+              {
+                "id": "how-to-cancel",
+                "heading": "How to cancel or reschedule",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Give one route to cancel and one to reschedule, and say whether a reschedule inside the notice period counts as a cancellation. If a booking confirmation carries a self-service link, name it here.",
+                    },
+                  ],
+              },
+              {
+                "id": "fees",
+                "heading": "Late cancellations and no-shows",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Say what a late cancellation costs and what a no-show costs, as a figure or a share of the booking, and when each is charged. If you hold a deposit, say what happens to it in each case.",
+                    },
+                  ],
+              },
+              {
+                "id": "our-cancellations",
+                "heading": "If we cancel",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Set out what a customer gets if you cancel or move an appointment — a full refund, a rebooking, or both — and how quickly you tell them. A policy that only binds one side reads as one.",
+                    },
+                  ],
+              },
+              {
+                "id": "exceptions",
+                "heading": "Exceptions",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Name the circumstances in which you waive a fee — illness, bereavement, severe weather — and say what you need from the customer to apply the waiver. Vague discretion is worse for you than a short written list.",
+                    },
+                  ],
+              },
+              {
+                "id": "contact",
+                "heading": "Questions about a booking",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Point to the one place a customer should write, and say roughly how quickly you answer.",
+                    },
+                  ],
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]`; the MDX body is not read by the section-catalog renderer. schema.org has no cancellation-policy type, so this page emits a plain WebPage (#5947, D2) — a real policy field reaches the JSON-LD through the `schema:` escape hatch, never a coined @type. */}

package/templates/content/en/ReturnsPolicyPage/returns.mdx

@@ -0,0 +1,108 @@
+---
+type: "ReturnsPolicyPage"
+slug: "returns"
+title: "Returns & Refunds"
+description: "How to return an order from this site, how long you have, and how refunds are issued."
+updatedAt: "2026-09-17"
+sections:
+  [
+    {
+      "id": "returns-document",
+      "type": "document-chassis",
+      "data":
+        {
+          "headline": "Returns & Refunds",
+          "backHref": "/",
+          "backLabel": "Back home",
+          "navGroupLabel": "Contents",
+          "stats":
+            [
+              { "label": "Last updated", "sublabel": "17 September 2026" },
+              { "label": "Applies to", "sublabel": "Orders placed on this site" },
+            ],
+          "sections":
+            [
+              {
+                "id": "intro",
+                "heading": "Returns & Refunds",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "This page explains how returns and refunds work on this site. Replace the starter copy below with the policy you actually operate — the headings are the ones a customer and an agent both look for, so keep them and fill in your own terms.",
+                    },
+                  ],
+              },
+              {
+                "id": "return-window",
+                "heading": "How long you have",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "State the return window in days, counted from a date a customer can verify — delivery, not dispatch. If different products carry different windows, say which, and say plainly which items cannot be returned at all.",
+                    },
+                  ],
+              },
+              {
+                "id": "condition",
+                "heading": "What condition an item must be in",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Describe the condition an item must come back in — unused, original packaging, tags attached, or whatever your standard is. Name anything that voids a return, such as a removed seal on a digital product or a personalised item.",
+                    },
+                  ],
+              },
+              {
+                "id": "how-to-return",
+                "heading": "How to start a return",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Give the customer one route to start a return and the information they need to hand: an order number, the item, and the reason. If you issue a return label, say who pays for it; if you do not, say that too.",
+                    },
+                  ],
+              },
+              {
+                "id": "refunds",
+                "heading": "How refunds are issued",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Say what a customer gets back — the item price, the original shipping, or both — and how long the refund takes to reach the payment method it came from. If you offer store credit or an exchange instead, describe when each applies.",
+                    },
+                  ],
+              },
+              {
+                "id": "exchanges",
+                "heading": "Exchanges and faulty items",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "A faulty or incorrectly shipped item is usually not an ordinary return. Set out how those are handled, and say whether the return window above applies to them.",
+                    },
+                  ],
+              },
+              {
+                "id": "contact",
+                "heading": "Questions about a return",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Point to the one place a customer should write, and say roughly how quickly you answer. A returns policy nobody can ask a question about is a policy that generates disputes.",
+                    },
+                  ],
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]`; the MDX body is not read by the section-catalog renderer. The JSON-LD for this page — a WebPage wrapping a MerchantReturnPolicy — is emitted by `buildReturnsPolicyPage` (#5947), not hand-rolled here. */}