@forgecart/cli 2.1.1 → 2.202606151453.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgecart/cli",
-  "version": "2.1.1",
+  "version": "2.202606151453.0",
   "type": "module",
   "description": "CLI for scaffolding and operating ForgeCart channel storefronts",
   "bin": {
@@ -26,7 +26,8 @@
     "node": ">=18.0.0"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "keywords": [
     "forgecart",

package/templates/storefront/README.md

@@ -37,7 +37,7 @@ never reaches the browser.
 
 ```bash
 npm install
-npm run dev      # next dev  -> http://localhost:3000
+npm run dev      # next dev --turbopack  -> http://localhost:3000
 ```
 
 A ForgeCart channel workspace serves this app as its live site by running

package/templates/storefront/next.config.js

@@ -4,6 +4,25 @@ const nextConfig = {
   // storefront with `next start` without a full node_modules tree.
   output: 'standalone',
   reactStrictMode: true,
+  // Dev-only `data-fc-source` stamping for the ForgeCart visual editor. The
+  // loader marks host JSX elements with their source file:line:col so the
+  // dashboard can map a sprayed region back to code. It runs under Turbopack
+  // before SWC — with no `as` field, Turbopack chains loader -> built-in SWC,
+  // so the stamped TSX is still compiled normally.
+  //
+  // GLOB GOTCHA (Next 15.5): Turbopack matches a rule key by FILENAME unless it
+  // contains `/` (then by full project-relative path), and it does NOT expand
+  // braces. The earlier `src/**/*.{tsx,jsx}` therefore matched nothing and the
+  // loader silently never ran (`data-fc-source` count: 0). Per-extension
+  // filename globs are what Turbopack honors. The loader self-gates on
+  // NODE_ENV === 'development', so `next build` (webpack, production) is
+  // untouched.
+  turbopack: {
+    rules: {
+      '*.tsx': { loaders: ['@forgecart/designer-runtime/turbo-loader'] },
+      '*.jsx': { loaders: ['@forgecart/designer-runtime/turbo-loader'] },
+    },
+  },
   images: {
     // The shop API serves product/asset previews from arbitrary hosts, so
     // allow any remote image. Tighten this to your asset host in production.

package/templates/storefront/package.json

@@ -3,11 +3,12 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
-    "dev": "next dev",
+    "dev": "next dev --turbopack",
     "build": "next build",
     "start": "next start"
   },
   "dependencies": {
+    "@forgecart/designer-runtime": "^1.0.0",
     "@forgecart/sdk": "^1.2.6",
     "next": "^15.1.0",
     "react": "^19.0.0",

package/templates/storefront/src/app/layout.tsx

@@ -1,6 +1,7 @@
 import type { Metadata } from 'next';
 import type { ReactNode } from 'react';
 
+import { ForgecartDesigner } from '../components/ForgecartDesigner';
 import { Header } from '../components/Header';
 import { getCart } from '../lib/cart-actions';
 import { CartProvider } from '../lib/cart-context';
@@ -26,6 +27,7 @@ export default async function RootLayout({ children }: { children: ReactNode })
             </div>
           </footer>
         </CartProvider>
+        <ForgecartDesigner />
       </body>
     </html>
   );

package/templates/storefront/src/components/ForgecartDesigner.tsx

@@ -0,0 +1,43 @@
+'use client';
+
+import { useEffect } from 'react';
+
+/**
+ * Mounts the ForgeCart visual-editor guest runtime. Renders nothing.
+ *
+ * The runtime stays dormant until activated: it registers a single `message`
+ * listener and posts a READY beacon, then waits for the dashboard host to
+ * drive a nonce-gated handshake over `postMessage` (the activation nonce
+ * arrives via the `#fcd=` URL fragment — there is no env switch). On a page
+ * that is not embedded in an iframe it never even loads.
+ *
+ * Production builds ship zero bytes of this: the literal `NODE_ENV` check is
+ * inlined by the bundler, so the effect body — including the dynamic import
+ * and its chunk — is dead-code-eliminated from `next build` output.
+ */
+export function ForgecartDesigner() {
+  useEffect(() => {
+    if (process.env.NODE_ENV !== 'development') {
+      return;
+    }
+    // Top-level pages have no designer host; skip loading the chunk entirely.
+    if (window.parent === window) {
+      return;
+    }
+    let cancelled = false;
+    let dispose: (() => void) | undefined;
+    const install = async () => {
+      const mod = await import('@forgecart/designer-runtime');
+      if (cancelled) {
+        return;
+      }
+      dispose = mod.installDesignerRuntime();
+    };
+    void install();
+    return () => {
+      cancelled = true;
+      dispose?.();
+    };
+  }, []);
+  return null;
+}

package/templates/storefront/src/lib/forgecart.ts

@@ -176,12 +176,23 @@ export function getStartingPrice(product: Product): number | null {
 }
 
 /**
- * Format a minor-unit price (cents) as a currency string. Defaults to USD;
- * pass a different ISO currency code as needed.
+ * Format a minor-unit price as a currency string. Defaults to USD; pass a
+ * different ISO currency code as needed.
+ *
+ * ForgeCart prices are integers in the currency's smallest denomination, so
+ * the divisor depends on the currency's ISO-4217 exponent: 2500 is $25.00
+ * (two-decimal cents) but ¥2,500 (zero-decimal yen) and BHD 2.500
+ * (three-decimal fils). The exponent is derived from the same
+ * `Intl.NumberFormat` instance that renders the price — its
+ * `resolvedOptions().maximumFractionDigits` carries the CLDR fraction digits
+ * for the currency — so the divisor always agrees with the digits shown,
+ * with a defensive fallback of 2 should the formatter resolve none.
  */
 export function formatPrice(minorUnits: number, currency = 'USD'): string {
-  return new Intl.NumberFormat('en-US', {
+  const formatter = new Intl.NumberFormat('en-US', {
     style: 'currency',
     currency,
-  }).format(minorUnits / 100);
+  });
+  const exponent = formatter.resolvedOptions().maximumFractionDigits ?? 2;
+  return formatter.format(minorUnits / 10 ** exponent);
 }