@shopbb/helium 0.5.10 → 0.6.1

package/dist/components/DiscountSelector.js

@@ -18,18 +18,15 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  */
 import * as React from 'react';
 import { useDiscounts } from './DiscountProvider';
-import { useAnalytics } from './AnalyticsProvider';
 import { Money } from './Money';
 import { useMounted } from './hooks/useMounted';
+import { CartForm } from './CartForm';
 export function DiscountSelector(props) {
     const { className, unauthenticatedFallback, renderApplied } = props;
     const mounted = useMounted();
-    const { myDiscounts, myDiscountsStatus, cartAllocations, appliedClaim, selectCartDiscount, } = useDiscounts();
-    const analytics = useAnalytics();
+    const { myDiscounts, myDiscountsStatus, cartAllocations, appliedClaim, } = useDiscounts();
     const [open, setOpen] = React.useState(false);
-    const [pending, setPending] = React.useState(false);
     // SSR + client 首次 render：返回固定占位，保证 hydration 不 mismatch。
-    // mounted 后才进入真正的渲染分支。
     if (!mounted) {
         return _jsx("div", { "data-discount-selector": true, "data-ssr-placeholder": true, className: className });
     }
@@ -38,17 +35,6 @@ export function DiscountSelector(props) {
     const appliedClaimId = appliedClaim?.claimId ?? null;
     const appliedTitle = appliedClaim?.title ?? appliedAlloc?.title;
     const appliedCode = appliedClaim?.code ?? appliedAlloc?.code;
-    const handleSelect = async (claimId) => {
-        setPending(true);
-        try {
-            await selectCartDiscount(claimId);
-            analytics.emit('discount_select', { claimId });
-        }
-        finally {
-            setPending(false);
-            setOpen(false);
-        }
-    };
     // 未登录
     if (myDiscountsStatus === 'unauthenticated') {
         return unauthenticatedFallback !== undefined ? _jsx(_Fragment, { children: unauthenticatedFallback }) : (_jsxs("div", { "data-discount-selector": true, "data-unauth": true, className: className, children: [_jsx("span", { children: "\u767B\u5F55\u540E\u53EF\u4F7F\u7528\u4F18\u60E0\u5238" }), _jsx("a", { href: "/login?next=/cart", children: "\u53BB\u767B\u5F55" })] }));
@@ -65,17 +51,20 @@ export function DiscountSelector(props) {
                     title: appliedTitle ?? '',
                     amount: appliedAlloc?.discountedAmount ?? { amount: '0', currencyCode: 'CNY' },
                     onChange: () => setOpen(true),
-                }) : (_jsxs("div", { "data-applied": true, children: [_jsxs("div", { "data-info": true, children: [_jsx("span", { "data-label": true, children: "\u5DF2\u4F7F\u7528" }), _jsx("strong", { "data-title": true, children: appliedTitle }), appliedAlloc && (_jsxs("span", { "data-amount": true, children: ["\u2212 ", _jsx(Money, { data: { amount: appliedAlloc.discountedAmount.amount, currencyCode: appliedAlloc.discountedAmount.currencyCode } })] }))] }), _jsx("div", { "data-actions": true, children: _jsx("button", { type: "button", onClick: () => setOpen(true), disabled: pending, children: "\u5207\u6362" }) })] }))) : (_jsxs("div", { "data-empty-applied": true, children: [_jsx("div", { "data-info": true, children: _jsxs("span", { "data-label": true, children: ["\u6709 ", availableClaims.length, " \u5F20\u53EF\u7528\u4F18\u60E0\u5238"] }) }), _jsx("button", { type: "button", onClick: () => setOpen(true), disabled: pending, children: "\u9009\u62E9" })] })) }), open && (_jsx(DiscountPickerSheet, { claims: availableClaims, currentClaimId: appliedClaimId, onSelect: handleSelect, onClose: () => setOpen(false), pending: pending }))] }));
+                }) : (_jsxs("div", { "data-applied": true, children: [_jsxs("div", { "data-info": true, children: [_jsx("span", { "data-label": true, children: "\u5DF2\u4F7F\u7528" }), _jsx("strong", { "data-title": true, children: appliedTitle }), appliedAlloc && (_jsxs("span", { "data-amount": true, children: ["\u2212 ", _jsx(Money, { data: { amount: appliedAlloc.discountedAmount.amount, currencyCode: appliedAlloc.discountedAmount.currencyCode } })] }))] }), _jsx("div", { "data-actions": true, children: _jsx("button", { type: "button", onClick: () => setOpen(true), children: "\u5207\u6362" }) })] }))) : (_jsxs("div", { "data-empty-applied": true, children: [_jsx("div", { "data-info": true, children: _jsxs("span", { "data-label": true, children: ["\u6709 ", availableClaims.length, " \u5F20\u53EF\u7528\u4F18\u60E0\u5238"] }) }), _jsx("button", { type: "button", onClick: () => setOpen(true), children: "\u9009\u62E9" })] })) }), open && (_jsx(DiscountPickerSheet, { claims: availableClaims, currentClaimId: appliedClaimId, onClose: () => setOpen(false) }))] }));
 }
 /**
  * 抽屉式选券面板。
  * Demo 实现为屏底固定面板；商家可以替换为 modal / 抽屉等。
  */
-function DiscountPickerSheet({ claims, currentClaimId, onSelect, onClose, pending, }) {
+function DiscountPickerSheet({ claims, currentClaimId, onClose, }) {
     return (_jsx("div", { "data-discount-picker-overlay": true, onClick: onClose, children: _jsxs("div", { "data-discount-picker-sheet": true, onClick: (e) => e.stopPropagation(), children: [_jsxs("div", { "data-sheet-header": true, children: [_jsx("h3", { children: "\u9009\u62E9\u4F18\u60E0\u5238" }), _jsx("button", { type: "button", onClick: onClose, "data-sheet-close": true, children: "\u00D7" })] }), _jsx("div", { "data-sheet-list": true, children: claims.map((c) => {
+                        // claim_id 既可能是 gid 也可能是 raw —— oxygen mutation 接受两种
                         const id = c.id.replace(/^gid:\/\/shopbb\/DiscountClaim\//, '');
                         const isCurrent = currentClaimId === id;
-                        return (_jsxs("button", { type: "button", "data-claim-card": true, "data-current": isCurrent ? '' : undefined, onClick: () => onSelect(id), disabled: pending, children: [_jsxs("div", { "data-claim-left": true, children: [_jsx("div", { "data-claim-value": true, children: formatValue(c) }), c.discount.minSubtotal && (_jsxs("div", { "data-claim-min": true, children: ["\u6EE1 ", _jsx(Money, { data: { amount: c.discount.minSubtotal.amount, currencyCode: c.discount.minSubtotal.currencyCode } }), " \u53EF\u7528"] }))] }), _jsxs("div", { "data-claim-right": true, children: [_jsx("div", { "data-claim-title": true, children: c.discount.title }), c.discount.code && _jsx("div", { "data-claim-code": true, children: c.discount.code }), c.expiresAt && (_jsxs("div", { "data-claim-expiry": true, children: [new Date(c.expiresAt).toLocaleDateString('zh-CN'), " \u8FC7\u671F"] }))] }), isCurrent && _jsx("span", { "data-claim-current-tag": true, children: "\u5F53\u524D\u4F7F\u7528" })] }, c.id));
+                        return (
+                        // 每张券一个 <CartForm>，submit 走 /cart action → cart.selectDiscount
+                        _jsx(CartForm, { action: "CustomDiscountSelect", inputs: { claimId: id }, children: (fetcher) => (_jsxs("button", { type: "submit", "data-claim-card": true, "data-current": isCurrent ? '' : undefined, disabled: fetcher.state !== 'idle', children: [_jsxs("div", { "data-claim-left": true, children: [_jsx("div", { "data-claim-value": true, children: formatValue(c) }), c.discount.minSubtotal && (_jsxs("div", { "data-claim-min": true, children: ["\u6EE1 ", _jsx(Money, { data: { amount: c.discount.minSubtotal.amount, currencyCode: c.discount.minSubtotal.currencyCode } }), " \u53EF\u7528"] }))] }), _jsxs("div", { "data-claim-right": true, children: [_jsx("div", { "data-claim-title": true, children: c.discount.title }), c.discount.code && _jsx("div", { "data-claim-code": true, children: c.discount.code }), c.expiresAt && (_jsxs("div", { "data-claim-expiry": true, children: [new Date(c.expiresAt).toLocaleDateString('zh-CN'), " \u8FC7\u671F"] }))] }), isCurrent && _jsx("span", { "data-claim-current-tag": true, children: "\u5F53\u524D\u4F7F\u7528" })] })) }, c.id));
                     }) })] }) }));
 }
 function formatValue(c) {

package/dist/components/DiscountSelector.js.map

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

package/dist/components/Image.d.ts

@@ -1,3 +1,21 @@
+/**
+ * IMAGE_FRAGMENT — 对齐 Hydrogen React 同名常量
+ *
+ * 商家在 GraphQL 查询里直接用：
+ *
+ *   import { IMAGE_FRAGMENT } from '@shopbb/helium';
+ *
+ *   const Q = `
+ *     ${IMAGE_FRAGMENT}
+ *     query {
+ *       product(handle: "x") {
+ *         featuredImage { ...Image }
+ *         images(first: 5) { nodes { ...Image } }
+ *       }
+ *     }
+ *   `;
+ */
+export declare const IMAGE_FRAGMENT = "\n  fragment Image on Image {\n    id\n    url\n    altText\n    width\n    height\n  }\n";
 /**
  * <Image> — 响应式商品图片
  *

package/dist/components/Image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../src/components/Image.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/G,cAAc;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAkBD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,2CAmCtC"}
+{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../src/components/Image.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,8FAQ1B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/G,cAAc;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAkBD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,2CAmCtC"}

package/dist/components/Image.js

@@ -1,4 +1,30 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * IMAGE_FRAGMENT — 对齐 Hydrogen React 同名常量
+ *
+ * 商家在 GraphQL 查询里直接用：
+ *
+ *   import { IMAGE_FRAGMENT } from '@shopbb/helium';
+ *
+ *   const Q = `
+ *     ${IMAGE_FRAGMENT}
+ *     query {
+ *       product(handle: "x") {
+ *         featuredImage { ...Image }
+ *         images(first: 5) { nodes { ...Image } }
+ *       }
+ *     }
+ *   `;
+ */
+export const IMAGE_FRAGMENT = /* GraphQL */ `
+  fragment Image on Image {
+    id
+    url
+    altText
+    width
+    height
+  }
+`;
 // 默认 srcset 档位
 const DEFAULT_WIDTHS = [375, 750, 1024, 1536, 1920];
 /** 给 url 加 ?width=N query */

package/dist/components/Image.js.map

@@ -1 +1 @@
-{"version":3,"file":"Image.js","sourceRoot":"","sources":["../../src/components/Image.tsx"],"names":[],"mappings":";AAyCA,eAAe;AACf,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEpD,6BAA6B;AAC7B,SAAS,SAAS,CAAC,GAAW,EAAE,KAAa;IAC3C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;QACnB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1C,OAAO,GAAG,GAAG,GAAG,GAAG,SAAS,KAAK,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,OAAO,GAAG,MAAM,EAChB,MAAM,GAAG,cAAc,EACvB,KAAK,EACL,GAAG,EAAE,OAAO,EACZ,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,YAAY;IACZ,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAwB;QACtC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,GAAG,KAAK;KACT,CAAC;IAEF,OAAO,CACL,iBACM,IAAI,EACR,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAClC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAC,OAAO,EAChB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS,EAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,EAChC,KAAK,EAAE,UAAU,GACjB,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"Image.js","sourceRoot":"","sources":["../../src/components/Image.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;;;;;;;;CAQ3C,CAAC;AA2CF,eAAe;AACf,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEpD,6BAA6B;AAC7B,SAAS,SAAS,CAAC,GAAW,EAAE,KAAa;IAC3C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;QACnB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1C,OAAO,GAAG,GAAG,GAAG,GAAG,SAAS,KAAK,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,OAAO,GAAG,MAAM,EAChB,MAAM,GAAG,cAAc,EACvB,KAAK,EACL,GAAG,EAAE,OAAO,EACZ,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,YAAY;IACZ,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAwB;QACtC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,GAAG,KAAK;KACT,CAAC;IAEF,OAAO,CACL,iBACM,IAAI,EACR,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAClC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAC,OAAO,EAChB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS,EAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,EAChC,KAAK,EAAE,UAAU,GACjB,CACH,CAAC;AACJ,CAAC"}

package/dist/components/Pagination.d.ts

@@ -0,0 +1,82 @@
+/**
+ * <Pagination> + getPaginationVariables() — 对齐 Hydrogen Pagination
+ *
+ * GraphQL cursor-based 分页（forward + backward）。SSR 友好：URL ?cursor= / ?direction= 控制。
+ *
+ * 用法（服务端 loader）：
+ *
+ *   const variables = getPaginationVariables(request, { pageBy: 20 });
+ *   // → { first: 20, last: undefined, startCursor: undefined, endCursor: undefined }
+ *   const data = await storefront.query(PRODUCTS_QUERY, { variables });
+ *
+ * 用法（组件）：
+ *
+ *   <Pagination connection={data.products}>
+ *     {({ nodes, hasNextPage, NextLink, hasPreviousPage, PreviousLink, state }) => (
+ *       <>
+ *         {hasPreviousPage && <PreviousLink>上一页</PreviousLink>}
+ *         <ul>{nodes.map((n) => <li key={n.id}>{n.title}</li>)}</ul>
+ *         {hasNextPage && <NextLink>下一页</NextLink>}
+ *       </>
+ *     )}
+ *   </Pagination>
+ */
+import * as React from 'react';
+export interface PaginationConnection<T = any> {
+    pageInfo: {
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+        startCursor?: string | null;
+        endCursor?: string | null;
+    };
+    nodes?: T[];
+    edges?: Array<{
+        node: T;
+        cursor?: string;
+    }>;
+}
+export interface PaginationVariables {
+    first?: number;
+    last?: number;
+    startCursor?: string | null;
+    endCursor?: string | null;
+}
+/**
+ * 从 request URL 解析分页 query params。
+ *
+ *   ?direction=next&cursor=xxx → { first: 20, endCursor: 'xxx' }
+ *   ?direction=previous&cursor=xxx → { last: 20, startCursor: 'xxx' }
+ *   (没 param) → { first: 20 }
+ */
+export declare function getPaginationVariables(request: Request, options?: {
+    pageBy?: number;
+}): PaginationVariables;
+export interface PaginationRenderProps<T> {
+    /** 拍平后的当前页 nodes */
+    nodes: T[];
+    /** Raw pageInfo（hasNextPage / hasPreviousPage 等） */
+    pageInfo: PaginationConnection['pageInfo'];
+    /** 当前 URL state */
+    state: {
+        direction: 'next' | 'previous' | null;
+        cursor: string | null;
+    };
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    /** "下一页" 链接组件（自动加 ?direction=next&cursor=...） */
+    NextLink: React.FC<{
+        children: React.ReactNode;
+        className?: string;
+    }>;
+    /** "上一页" 链接组件 */
+    PreviousLink: React.FC<{
+        children: React.ReactNode;
+        className?: string;
+    }>;
+}
+export interface PaginationProps<T> {
+    connection: PaginationConnection<T>;
+    children: (props: PaginationRenderProps<T>) => React.ReactNode;
+}
+export declare function Pagination<T>(props: PaginationProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Pagination.d.ts.map

package/dist/components/Pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../src/components/Pagination.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,GAAG;IAC3C,QAAQ,EAAE;QACR,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,mBAAmB,CAYrB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,oBAAoB;IACpB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,oDAAoD;IACpD,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,mBAAmB;IACnB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAExE,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,iBAAiB;IACjB,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CAChE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,2CA8CtD"}

package/dist/components/Pagination.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * <Pagination> + getPaginationVariables() — 对齐 Hydrogen Pagination
+ *
+ * GraphQL cursor-based 分页（forward + backward）。SSR 友好：URL ?cursor= / ?direction= 控制。
+ *
+ * 用法（服务端 loader）：
+ *
+ *   const variables = getPaginationVariables(request, { pageBy: 20 });
+ *   // → { first: 20, last: undefined, startCursor: undefined, endCursor: undefined }
+ *   const data = await storefront.query(PRODUCTS_QUERY, { variables });
+ *
+ * 用法（组件）：
+ *
+ *   <Pagination connection={data.products}>
+ *     {({ nodes, hasNextPage, NextLink, hasPreviousPage, PreviousLink, state }) => (
+ *       <>
+ *         {hasPreviousPage && <PreviousLink>上一页</PreviousLink>}
+ *         <ul>{nodes.map((n) => <li key={n.id}>{n.title}</li>)}</ul>
+ *         {hasNextPage && <NextLink>下一页</NextLink>}
+ *       </>
+ *     )}
+ *   </Pagination>
+ */
+import * as React from 'react';
+import { flattenConnection } from '../utils/flattenConnection';
+const DEFAULT_PAGE_BY = 20;
+/**
+ * 从 request URL 解析分页 query params。
+ *
+ *   ?direction=next&cursor=xxx → { first: 20, endCursor: 'xxx' }
+ *   ?direction=previous&cursor=xxx → { last: 20, startCursor: 'xxx' }
+ *   (没 param) → { first: 20 }
+ */
+export function getPaginationVariables(request, options = {}) {
+    const { pageBy = DEFAULT_PAGE_BY } = options;
+    const url = new URL(request.url);
+    const direction = url.searchParams.get('direction');
+    const cursor = url.searchParams.get('cursor');
+    if (direction === 'previous' && cursor) {
+        return { last: pageBy, startCursor: cursor };
+    }
+    if (direction === 'next' && cursor) {
+        return { first: pageBy, endCursor: cursor };
+    }
+    return { first: pageBy };
+}
+export function Pagination(props) {
+    const { connection, children } = props;
+    const pageInfo = connection.pageInfo;
+    const nodes = flattenConnection(connection);
+    // 当前 URL state（hydrate 后才能访问 window.location）
+    const [urlState, setUrlState] = React.useState({
+        direction: null, cursor: null,
+    });
+    React.useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const params = new URLSearchParams(window.location.search);
+        const d = params.get('direction');
+        setUrlState({
+            direction: d === 'next' || d === 'previous' ? d : null,
+            cursor: params.get('cursor'),
+        });
+    }, []);
+    const nextHref = pageInfo.endCursor
+        ? `?direction=next&cursor=${encodeURIComponent(pageInfo.endCursor)}`
+        : '#';
+    const prevHref = pageInfo.startCursor
+        ? `?direction=previous&cursor=${encodeURIComponent(pageInfo.startCursor)}`
+        : '#';
+    const NextLink = ({ children, className }) => (_jsx("a", { href: nextHref, className: className, "data-pagination-next": true, children: children }));
+    const PreviousLink = ({ children, className }) => (_jsx("a", { href: prevHref, className: className, "data-pagination-prev": true, children: children }));
+    return (_jsx(_Fragment, { children: children({
+            nodes,
+            pageInfo,
+            state: urlState,
+            hasNextPage: pageInfo.hasNextPage,
+            hasPreviousPage: pageInfo.hasPreviousPage,
+            NextLink,
+            PreviousLink,
+        }) }));
+}
+//# sourceMappingURL=Pagination.js.map

package/dist/components/Pagination.js.map

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

package/dist/components/RichText.d.ts

@@ -0,0 +1,78 @@
+/**
+ * <RichText> — 对齐 Hydrogen React
+ *
+ * 渲染 Shopify rich-text metafield 的 JSON 结构。Shopify rich-text 标准格式：
+ *
+ *   {
+ *     type: "root",
+ *     children: [
+ *       { type: "heading", level: 1, children: [{type: "text", value: "Hello"}] },
+ *       { type: "paragraph", children: [
+ *         {type: "text", value: "Hello "},
+ *         {type: "text", value: "world", bold: true},
+ *         {type: "link", url: "...", children: [{type: "text", value: "click"}]},
+ *       ]},
+ *     ],
+ *   }
+ *
+ * 用法：
+ *   const rich = JSON.parse(product.descriptionRichText);
+ *   <RichText data={rich} />
+ *
+ *   // 自定义节点渲染（覆盖默认）
+ *   <RichText data={rich} components={{ heading: ({level, children}) =>
+ *     React.createElement(`h${level}`, {className: 'my-h'}, children) }} />
+ */
+import * as React from 'react';
+export interface RichTextNode {
+    type: string;
+    value?: string;
+    level?: number;
+    url?: string;
+    title?: string;
+    target?: string;
+    bold?: boolean;
+    italic?: boolean;
+    listType?: 'ordered' | 'unordered';
+    children?: RichTextNode[];
+}
+export interface RichTextComponents {
+    root?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    paragraph?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    heading?: (props: {
+        level: number;
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    list?: (props: {
+        listType: 'ordered' | 'unordered';
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    listItem?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    link?: (props: {
+        url: string;
+        title?: string;
+        target?: string;
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    text?: (props: {
+        value: string;
+        bold?: boolean;
+        italic?: boolean;
+    }) => React.ReactElement;
+}
+export interface RichTextProps {
+    /** Rich-text JSON object（已 parse 过的）或者 JSON string */
+    data: RichTextNode | string | null | undefined;
+    /** 自定义渲染器 */
+    components?: RichTextComponents;
+    /** 包裹容器 className */
+    className?: string;
+}
+export declare function RichText({ data, components, className }: RichTextProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=RichText.d.ts.map

package/dist/components/RichText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../../src/components/RichText.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACnC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACpE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACtF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,SAAS,GAAG,WAAW,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACvG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACxE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IAClH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;CAC3F;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,aAAa;IACb,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6CD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,aAAa,kDAkBtE"}

package/dist/components/RichText.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * <RichText> — 对齐 Hydrogen React
+ *
+ * 渲染 Shopify rich-text metafield 的 JSON 结构。Shopify rich-text 标准格式：
+ *
+ *   {
+ *     type: "root",
+ *     children: [
+ *       { type: "heading", level: 1, children: [{type: "text", value: "Hello"}] },
+ *       { type: "paragraph", children: [
+ *         {type: "text", value: "Hello "},
+ *         {type: "text", value: "world", bold: true},
+ *         {type: "link", url: "...", children: [{type: "text", value: "click"}]},
+ *       ]},
+ *     ],
+ *   }
+ *
+ * 用法：
+ *   const rich = JSON.parse(product.descriptionRichText);
+ *   <RichText data={rich} />
+ *
+ *   // 自定义节点渲染（覆盖默认）
+ *   <RichText data={rich} components={{ heading: ({level, children}) =>
+ *     React.createElement(`h${level}`, {className: 'my-h'}, children) }} />
+ */
+import * as React from 'react';
+const DEFAULTS = {
+    root: ({ children }) => _jsx("div", { "data-rich-text": true, children: children }),
+    paragraph: ({ children }) => _jsx("p", { children: children }),
+    heading: ({ level, children }) => React.createElement(`h${Math.min(Math.max(level, 1), 6)}`, null, children),
+    list: ({ listType, children }) => (listType === 'ordered' ? _jsx("ol", { children: children }) : _jsx("ul", { children: children })),
+    listItem: ({ children }) => _jsx("li", { children: children }),
+    link: ({ url, title, target, children }) => (_jsx("a", { href: url, title: title, target: target, rel: target === '_blank' ? 'noopener noreferrer' : undefined, children: children })),
+    text: ({ value, bold, italic }) => {
+        let out = value;
+        if (italic)
+            out = _jsx("em", { children: out });
+        if (bold)
+            out = _jsx("strong", { children: out });
+        return _jsx(_Fragment, { children: out });
+    },
+};
+function renderNode(node, comps, key) {
+    if (!node)
+        return null;
+    const childrenNodes = (node.children || []).map((c, i) => renderNode(c, comps, i));
+    switch (node.type) {
+        case 'root':
+            return _jsx(React.Fragment, { children: comps.root({ children: childrenNodes }) }, key);
+        case 'paragraph':
+            return _jsx(React.Fragment, { children: comps.paragraph({ children: childrenNodes }) }, key);
+        case 'heading':
+            return _jsx(React.Fragment, { children: comps.heading({ level: node.level || 2, children: childrenNodes }) }, key);
+        case 'list':
+            return _jsx(React.Fragment, { children: comps.list({ listType: node.listType || 'unordered', children: childrenNodes }) }, key);
+        case 'list-item':
+            return _jsx(React.Fragment, { children: comps.listItem({ children: childrenNodes }) }, key);
+        case 'link':
+            return _jsx(React.Fragment, { children: comps.link({ url: node.url || '#', title: node.title, target: node.target, children: childrenNodes }) }, key);
+        case 'text':
+            return _jsx(React.Fragment, { children: comps.text({ value: node.value || '', bold: node.bold, italic: node.italic }) }, key);
+        default:
+            // unknown type — 递归 children 不出错
+            return _jsx(React.Fragment, { children: childrenNodes }, key);
+    }
+}
+export function RichText({ data, components, className }) {
+    let parsed = null;
+    if (!data)
+        return null;
+    if (typeof data === 'string') {
+        try {
+            parsed = JSON.parse(data);
+        }
+        catch {
+            return _jsx("div", { className: className, children: data });
+        }
+    }
+    else {
+        parsed = data;
+    }
+    if (!parsed)
+        return null;
+    const comps = { ...DEFAULTS, ...(components || {}) };
+    const rendered = renderNode(parsed, comps, 0);
+    if (className && parsed.type === 'root') {
+        // 简单包一层，给 root 加 className
+        return _jsx("div", { className: className, "data-rich-text": true, children: rendered });
+    }
+    return _jsx(_Fragment, { children: rendered });
+}
+//# sourceMappingURL=RichText.js.map

package/dist/components/RichText.js.map

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

package/dist/components/Seo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * <Seo data={SeoConfig} /> — 对齐 Hydrogen React
+ *
+ * Hydrogen 在 Remix 里用 `meta` export 注入 head；我们在客户端用 `<Seo>`
+ * 做 SPA 路由切换时的 document.title / meta 动态更新。
+ *
+ * SSR 阶段 Seo 组件渲染为 null（不输出 DOM）；服务端商家应该用 getSeoMeta
+ * 生成 head HTML 直接拼到 <head>。
+ *
+ * 用法（客户端 SPA navigate 时）：
+ *
+ *   <Seo data={{
+ *     title: product.title,
+ *     description: product.description,
+ *     image: product.featuredImage?.url,
+ *     url: location.href,
+ *     type: 'product',
+ *   }} />
+ */
+import { type SeoConfig } from '../seo/getSeoMeta';
+export interface SeoProps {
+    data: SeoConfig;
+}
+export declare function Seo({ data }: SeoProps): null;
+//# sourceMappingURL=Seo.d.ts.map

package/dist/components/Seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Seo.d.ts","sourceRoot":"","sources":["../../src/components/Seo.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,wBAAgB,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,QAiCrC"}

package/dist/components/Seo.js

@@ -0,0 +1,54 @@
+/**
+ * <Seo data={SeoConfig} /> — 对齐 Hydrogen React
+ *
+ * Hydrogen 在 Remix 里用 `meta` export 注入 head；我们在客户端用 `<Seo>`
+ * 做 SPA 路由切换时的 document.title / meta 动态更新。
+ *
+ * SSR 阶段 Seo 组件渲染为 null（不输出 DOM）；服务端商家应该用 getSeoMeta
+ * 生成 head HTML 直接拼到 <head>。
+ *
+ * 用法（客户端 SPA navigate 时）：
+ *
+ *   <Seo data={{
+ *     title: product.title,
+ *     description: product.description,
+ *     image: product.featuredImage?.url,
+ *     url: location.href,
+ *     type: 'product',
+ *   }} />
+ */
+import * as React from 'react';
+import { getSeoMeta } from '../seo/getSeoMeta';
+export function Seo({ data }) {
+    React.useEffect(() => {
+        if (typeof document === 'undefined')
+            return;
+        const seo = getSeoMeta(data);
+        if (seo.fullTitle)
+            document.title = seo.fullTitle;
+        // 同步关键 meta：description / og:* / twitter:*
+        for (const m of seo.meta) {
+            const attr = m.name ? 'name' : 'property';
+            const key = m.name || m.property;
+            let el = document.querySelector(`meta[${attr}="${key}"]`);
+            if (!el) {
+                el = document.createElement('meta');
+                el.setAttribute(attr, key);
+                document.head.appendChild(el);
+            }
+            el.setAttribute('content', m.content);
+        }
+        // canonical
+        if (data.url) {
+            let canon = document.querySelector('link[rel="canonical"]');
+            if (!canon) {
+                canon = document.createElement('link');
+                canon.setAttribute('rel', 'canonical');
+                document.head.appendChild(canon);
+            }
+            canon.setAttribute('href', data.url);
+        }
+    }, [data]);
+    return null;
+}
+//# sourceMappingURL=Seo.js.map

package/dist/components/Seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Seo.js","sourceRoot":"","sources":["../../src/components/Seo.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AAM/D,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAY;IACpC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAC5C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,GAAG,CAAC,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC;QAElD,2CAA2C;QAC3C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;YAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAS,CAAC;YAClC,IAAI,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,IAAI,KAAK,GAAG,IAAI,CAA2B,CAAC;YACpF,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACpC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;YACD,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,YAAY;QACZ,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,uBAAuB,CAA2B,CAAC;YACtF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACvC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YACD,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,IAAI,CAAC;AACd,CAAC"}