@vtex/faststore 0.0.4 → 0.0.6

package/dist/matter/account-access-gate/sign-out-intent.js

@@ -0,0 +1,62 @@
+"use client";
+import { useSyncExternalStore } from "react";
+//#region src/matter/account-access-gate/sign-out-intent.ts
+/**
+* The signal that tells `AccountAccessGate` a signed-out session is the shopper's own doing.
+*
+* Without it the two fight each other: `$actions.session.logout` resolves with the refreshed session
+* in its payload, so the tri-state flips to anonymous *in place*, while the shopper is still standing
+* on an account page. The gate would read that as any other signed-out shopper and redirect to
+* sign-in, carrying a return to the account they just left — racing the sign-out's own navigation.
+*
+* Deliberately not persisted. The intent authorizes exactly one transition and dies with the document
+* that authorized it, which is why the full load to `/` needs no cleanup. The one case where the
+* document comes back with the flag still standing is a back-forward cache restore, and the gate
+* withdraws it there.
+*/
+let intended = false;
+const subscribers = /* @__PURE__ */ new Set();
+function notify() {
+	for (const subscriber of subscribers) subscriber();
+}
+/**
+* Records that a sign-out is under way. Declared **before** the logout is awaited: the payload
+* refreshes the session in place, and a gate that got its turn between the response landing and the
+* navigation starting would redirect out from under the sign-out.
+*/
+function declareSignOutIntent() {
+	if (intended) return;
+	intended = true;
+	notify();
+}
+/**
+* Takes the intent back. Called when the logout resolves with user errors — the shopper is still
+* signed in and stays on the account page with the failure surfaced — and by the gate on a restored
+* document, where the navigation the intent authorized has already happened.
+*/
+function withdrawSignOutIntent() {
+	if (!intended) return;
+	intended = false;
+	notify();
+}
+function subscribe(onStoreChange) {
+	subscribers.add(onStoreChange);
+	return () => {
+		subscribers.delete(onStoreChange);
+	};
+}
+function getSnapshot() {
+	return intended;
+}
+/** Server renders never carry an intent: nothing has been able to click sign out yet. */
+function getServerSnapshot() {
+	return false;
+}
+/** Whether a sign-out is under way, re-rendering the caller when that changes. */
+function useSignOutIntent() {
+	return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+//#endregion
+export { declareSignOutIntent, useSignOutIntent, withdrawSignOutIntent };
+
+//# sourceMappingURL=sign-out-intent.js.map

package/dist/matter/account-access-gate/sign-out-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-out-intent.js","names":[],"sources":["../../../src/matter/account-access-gate/sign-out-intent.ts"],"sourcesContent":["'use client';\n\nimport { useSyncExternalStore } from 'react';\n\n/**\n * The signal that tells `AccountAccessGate` a signed-out session is the shopper's own doing.\n *\n * Without it the two fight each other: `$actions.session.logout` resolves with the refreshed session\n * in its payload, so the tri-state flips to anonymous *in place*, while the shopper is still standing\n * on an account page. The gate would read that as any other signed-out shopper and redirect to\n * sign-in, carrying a return to the account they just left — racing the sign-out's own navigation.\n *\n * Deliberately not persisted. The intent authorizes exactly one transition and dies with the document\n * that authorized it, which is why the full load to `/` needs no cleanup. The one case where the\n * document comes back with the flag still standing is a back-forward cache restore, and the gate\n * withdraws it there.\n */\nlet intended = false;\n\nconst subscribers = new Set<() => void>();\n\nfunction notify(): void {\n  for (const subscriber of subscribers) {\n    subscriber();\n  }\n}\n\n/**\n * Records that a sign-out is under way. Declared **before** the logout is awaited: the payload\n * refreshes the session in place, and a gate that got its turn between the response landing and the\n * navigation starting would redirect out from under the sign-out.\n */\nexport function declareSignOutIntent(): void {\n  if (intended) {\n    return;\n  }\n  intended = true;\n  notify();\n}\n\n/**\n * Takes the intent back. Called when the logout resolves with user errors — the shopper is still\n * signed in and stays on the account page with the failure surfaced — and by the gate on a restored\n * document, where the navigation the intent authorized has already happened.\n */\nexport function withdrawSignOutIntent(): void {\n  if (!intended) {\n    return;\n  }\n  intended = false;\n  notify();\n}\n\nfunction subscribe(onStoreChange: () => void): () => void {\n  subscribers.add(onStoreChange);\n  return () => {\n    subscribers.delete(onStoreChange);\n  };\n}\n\nfunction getSnapshot(): boolean {\n  return intended;\n}\n\n/** Server renders never carry an intent: nothing has been able to click sign out yet. */\nfunction getServerSnapshot(): boolean {\n  return false;\n}\n\n/** Whether a sign-out is under way, re-rendering the caller when that changes. */\nexport function useSignOutIntent(): boolean {\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,IAAI,WAAW;AAEf,MAAM,8BAAc,IAAI,IAAgB;AAExC,SAAS,SAAe;CACtB,KAAK,MAAM,cAAc,aACvB,WAAW;AAEf;;;;;;AAOA,SAAgB,uBAA6B;CAC3C,IAAI,UACF;CAEF,WAAW;CACX,OAAO;AACT;;;;;;AAOA,SAAgB,wBAA8B;CAC5C,IAAI,CAAC,UACH;CAEF,WAAW;CACX,OAAO;AACT;AAEA,SAAS,UAAU,eAAuC;CACxD,YAAY,IAAI,aAAa;CAC7B,aAAa;EACX,YAAY,OAAO,aAAa;CAClC;AACF;AAEA,SAAS,cAAuB;CAC9B,OAAO;AACT;;AAGA,SAAS,oBAA6B;CACpC,OAAO;AACT;;AAGA,SAAgB,mBAA4B;CAC1C,OAAO,qBAAqB,WAAW,aAAa,iBAAiB;AACvE"}

package/dist/matter/account-entry-point/account-entry-point.js

@@ -3,9 +3,9 @@ import { defineComponent } from "../../core/dist/define-component.js";
 import { defineContentType } from "../../core/dist/define-content-type.js";
 import "../../core/dist/index.js";
 import { useSession } from "../session/session.js";
-import { Icon } from "../../particles/icon/icon.js";
 import { resolveSignInHref } from "../../utils/safe-href.js";
 import { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
+import { Icon } from "../../particles/icon/icon.js";
 import { useEffect, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { usePathname } from "next/navigation";
@@ -72,7 +72,7 @@ const AccountEntryPointDefinition = defineComponent({
 			label: "Loading Announcement"
 		}
 	},
-	guideline: "Session-aware header control rendering one link: the signed-out label toward /login for anonymous and identified shoppers, the signed-in label toward the account route for logged-in ones, and a politely announced placeholder while the session resolves. Both destinations are fixed conventions, not props, so no authored value can misroute the auth flow. Must be inside a SessionRoot, normally the one hosted by the shared layout — a page-hosted provider resolves the session server-side without the shopper cookie and sticks on the signed-out label. Author the label for a state or that state renders nothing; the labels are optional in the type only because a CMS entry may supply them, and an entry overrides all four fields at runtime. Style it through data-fs-account-entry-point and switch on data-fs-account-entry-point-state."
+	guideline: "Session-aware header control rendering one link: the signed-out label toward /login for anonymous and identified shoppers, the signed-in label toward the account route for logged-in ones, and a politely announced placeholder while the session resolves. Both destinations are fixed conventions, not props, so no authored value can misroute the auth flow. Must be inside a SessionRoot, normally the one hosted by the shared layout; a page-hosted provider also works, since the server-side session fetch forwards the shopper cookie. Author the label for a state or that state renders nothing; the labels are optional in the type only because a CMS entry may supply them, and an entry overrides all four fields at runtime. Style it through data-fs-account-entry-point and switch on data-fs-account-entry-point-state."
 });
 function AccountEntryPoint({ signedOutLabel, signedInLabel, icon, loadingLabel, $content, className, ref, ...props }) {
 	const { state, loading } = useSession();

package/dist/matter/account-entry-point/account-entry-point.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-entry-point.js","names":[],"sources":["../../../src/matter/account-entry-point/account-entry-point.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport { usePathname } from 'next/navigation';\nimport { type ComponentPropsWithRef, useEffect, useState } from 'react';\nimport { Icon } from '../../particles/icon/icon.js';\nimport { NavigationLink } from '../../particles/navigation-link/navigation-link.js';\nimport { resolveSignInHref } from '../../utils/safe-href.js';\nimport { useSession } from '../session/session.js';\n\n/** The account's root. A fixed convention, never an authored value: an authored destination could\n *  misroute the entry into the account. */\nconst ACCOUNT_ROUTE = '/account';\n\n// Nothing is required: an entry may author any subset, and a slice missing a required property is\n// shape-invalid, which drops the whole element rather than the one field.\nexport const AccountEntryPointContent = defineContentType({\n  id: 'account-entry-point',\n  title: 'Account Entry Point',\n  description: 'Labels and icon for the header sign-in / account control.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      signedOutLabel: { type: 'string', minLength: 1, title: 'Signed-out label' },\n      signedInLabel: { type: 'string', minLength: 1, title: 'Signed-in label' },\n      icon: { type: 'string', minLength: 1, title: 'Icon' },\n      loadingLabel: { type: 'string', minLength: 1, title: 'Loading announcement' },\n    },\n  },\n});\n\n/** Props for {@link AccountEntryPoint}. Extends native `<a>` attributes (the rendered root). */\nexport type AccountEntryPointProps = Omit<ComponentPropsWithRef<'a'>, 'href' | 'children'> & {\n  /** Label for anonymous and identified shoppers. Optional: the render gate, not the type,\n   *  requires a resolved value. */\n  signedOutLabel?: string;\n  /** Label for logged-in shoppers. Same gate. */\n  signedInLabel?: string;\n  /** Icon reference for the glyph. Never gated: a control with no glyph is a valid configuration. */\n  icon?: string;\n  /** Text the live region announces while the session resolves. */\n  loadingLabel?: string;\n  /** Merchant-authored fields, sliced from the page/layout content entry; win over the props field\n   *  by field when present. Absent in a non-CMS store — the props are the fallback. */\n  $content?: ContentValue<typeof AccountEntryPointContent>;\n};\n\n/** Props for {@link AccountEntryPointLoading}. Extends native `<span>` attributes. */\nexport type AccountEntryPointLoadingProps = Omit<ComponentPropsWithRef<'span'>, 'children'>;\n\nexport const AccountEntryPointDefinition = defineComponent<AccountEntryPointProps>({\n  name: 'AccountEntryPoint',\n  importPath: '@vtex/faststore/components',\n  component: AccountEntryPoint,\n  content: AccountEntryPointContent,\n  editor: { label: 'Account Entry Point', category: 'identity' },\n  requiresContext: 'session',\n  schema: {\n    signedOutLabel: { type: 'string', label: 'Signed-out Label' },\n    signedInLabel: { type: 'string', label: 'Signed-in Label' },\n    icon: { type: 'icon', label: 'Icon' },\n    loadingLabel: { type: 'string', label: 'Loading Announcement' },\n  },\n  guideline:\n    'Session-aware header control rendering one link: the signed-out label toward /login for anonymous and identified shoppers, the signed-in label toward the account route for logged-in ones, and a politely announced placeholder while the session resolves. Both destinations are fixed conventions, not props, so no authored value can misroute the auth flow. Must be inside a SessionRoot, normally the one hosted by the shared layout — a page-hosted provider resolves the session server-side without the shopper cookie and sticks on the signed-out label. Author the label for a state or that state renders nothing; the labels are optional in the type only because a CMS entry may supply them, and an entry overrides all four fields at runtime. Style it through data-fs-account-entry-point and switch on data-fs-account-entry-point-state.',\n});\n\nexport function AccountEntryPoint({\n  signedOutLabel,\n  signedInLabel,\n  icon,\n  loadingLabel,\n  $content,\n  className,\n  ref,\n  ...props\n}: AccountEntryPointProps) {\n  const { state, loading } = useSession();\n  const pathname = usePathname();\n\n  // Blank entry fields fall through, so clearing one in the Admin reads as unauthored.\n  const entrySignedOutLabel = $content?.signedOutLabel?.trim() ? $content.signedOutLabel : signedOutLabel;\n  const entrySignedInLabel = $content?.signedInLabel?.trim() ? $content.signedInLabel : signedInLabel;\n  const entryIcon = $content?.icon?.trim() ? $content.icon : icon;\n  const entryLoadingLabel = $content?.loadingLabel?.trim() ? $content.loadingLabel : loadingLabel;\n\n  // Assistive technology only reports a change inside a region that was already in the tree, so a\n  // region mounted together with its text announces nothing. The region therefore holds the same\n  // position in both branches — React keeps it mounted across the swap — and starts empty, with the\n  // label written on the pass after mount and cleared again once the session resolves.\n  //\n  // It trails the branch content rather than leading it so the authored swatch, which lands on\n  // whichever element leads, can still reach the region through a following-sibling selector.\n  const [announcement, setAnnouncement] = useState('');\n  const resolvingLabel = loading ? entryLoadingLabel : undefined;\n  useEffect(() => {\n    setAnnouncement(resolvingLabel ?? '');\n  }, [resolvingLabel]);\n\n  // Gate on `loading` before `state`: an unresolved session reports `anonymous`, so reading the\n  // tri-state first would flash \"Sign In\" at a shopper who is already signed in.\n  if (loading) {\n    return (\n      <>\n        <AccountEntryPointLoading {...props} className={className} />\n        <AccountEntryPointAnnouncement>{announcement}</AccountEntryPointAnnouncement>\n      </>\n    );\n  }\n\n  // `identified` stays on the signed-out link: an identified but unauthenticated shopper cannot\n  // reach their account yet.\n  const signedIn = state === 'loggedIn';\n  const label = signedIn ? entrySignedInLabel : entrySignedOutLabel;\n\n  // A focusable link a screen reader announces as its bare URL is worse than no control at all.\n  if (!label?.trim()) {\n    return null;\n  }\n\n  return (\n    <>\n      <NavigationLink\n        {...props}\n        ref={ref}\n        href={signedIn ? ACCOUNT_ROUTE : resolveSignInHref(pathname)}\n        // The signed-out destination is a deferred auth proxy that may set a cookie or redirect, and\n        // a header control is always in the viewport — the default prefetch would fire that GET on\n        // every page view. The account route is an ordinary page, so it keeps the default.\n        prefetch={signedIn ? undefined : false}\n        className={className}\n        data-fs-account-entry-point=\"\"\n        data-fs-account-entry-point-state={signedIn ? 'signed-in' : 'signed-out'}\n      >\n        {entryIcon ? <Icon name={entryIcon} /> : null}\n        <span data-fs-account-entry-point-label=\"\">{label}</span>\n      </NavigationLink>\n      <AccountEntryPointAnnouncement>{announcement}</AccountEntryPointAnnouncement>\n    </>\n  );\n}\n\n/**\n * The live region that carries the control across the wait. Separate from the visual placeholder\n * because it has to outlive it: the placeholder is only in the tree while the session resolves,\n * while the region has to be there before the text lands for the text to be announced at all.\n */\nfunction AccountEntryPointAnnouncement({ children }: { children: string }) {\n  return (\n    <output aria-live=\"polite\" data-fs-account-entry-point-announcement=\"\">\n      {children}\n    </output>\n  );\n}\n\n/**\n * The visual stand-in occupying the control's slot while the session resolves. Purely visual: the\n * wait is spoken by the sibling live region, so this is hidden from assistive technology rather\n * than announced twice. Named for the state it represents, as `ShippingSimulatorLoading` is, not\n * for the bar it draws.\n */\nexport function AccountEntryPointLoading({ className, ...props }: AccountEntryPointLoadingProps) {\n  return <span {...props} aria-hidden=\"true\" className={className} data-fs-account-entry-point-loading=\"\" />;\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,gBAAgB;AAItB,MAAa,2BAA2B,kBAAkB;CACxD,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY;GACV,gBAAgB;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAmB;GAC1E,eAAe;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAkB;GACxE,MAAM;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAO;GACpD,cAAc;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAuB;EAC9E;CACF;AACF,CAAC;AAqBD,MAAa,8BAA8B,gBAAwC;CACjF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAuB,UAAU;CAAW;CAC7D,iBAAiB;CACjB,QAAQ;EACN,gBAAgB;GAAE,MAAM;GAAU,OAAO;EAAmB;EAC5D,eAAe;GAAE,MAAM;GAAU,OAAO;EAAkB;EAC1D,MAAM;GAAE,MAAM;GAAQ,OAAO;EAAO;EACpC,cAAc;GAAE,MAAM;GAAU,OAAO;EAAuB;CAChE;CACA,WACE;AACJ,CAAC;AAED,SAAgB,kBAAkB,EAChC,gBACA,eACA,MACA,cACA,UACA,WACA,KACA,GAAG,SACsB;CACzB,MAAM,EAAE,OAAO,YAAY,WAAW;CACtC,MAAM,WAAW,YAAY;CAG7B,MAAM,sBAAsB,UAAU,gBAAgB,KAAK,IAAI,SAAS,iBAAiB;CACzF,MAAM,qBAAqB,UAAU,eAAe,KAAK,IAAI,SAAS,gBAAgB;CACtF,MAAM,YAAY,UAAU,MAAM,KAAK,IAAI,SAAS,OAAO;CAC3D,MAAM,oBAAoB,UAAU,cAAc,KAAK,IAAI,SAAS,eAAe;CASnF,MAAM,CAAC,cAAc,mBAAmB,SAAS,EAAE;CACnD,MAAM,iBAAiB,UAAU,oBAAoB,KAAA;CACrD,gBAAgB;EACd,gBAAgB,kBAAkB,EAAE;CACtC,GAAG,CAAC,cAAc,CAAC;CAInB,IAAI,SACF,OACE,qBAAA,UAAA,EAAA,UAAA,CACE,oBAAC,0BAAD;EAA0B,GAAI;EAAkB;CAAY,CAAA,GAC5D,oBAAC,+BAAD,EAAA,UAAgC,aAA4C,CAAA,CAC5E,EAAA,CAAA;CAMN,MAAM,WAAW,UAAU;CAC3B,MAAM,QAAQ,WAAW,qBAAqB;CAG9C,IAAI,CAAC,OAAO,KAAK,GACf,OAAO;CAGT,OACE,qBAAA,UAAA,EAAA,UAAA,CACE,qBAAC,gBAAD;EACE,GAAI;EACC;EACL,MAAM,WAAW,gBAAgB,kBAAkB,QAAQ;EAI3D,UAAU,WAAW,KAAA,IAAY;EACtB;EACX,+BAA4B;EAC5B,qCAAmC,WAAW,cAAc;EAV9D,UAAA,CAYG,YAAY,oBAAC,MAAD,EAAM,MAAM,UAAY,CAAA,IAAI,MACzC,oBAAC,QAAD;GAAM,qCAAkC;GAAI,UAAA;EAAY,CAAA,CAC1C;CAChB,CAAA,GAAA,oBAAC,+BAAD,EAAA,UAAgC,aAA4C,CAAA,CAC5E,EAAA,CAAA;AAEN;;;;;;AAOA,SAAS,8BAA8B,EAAE,YAAkC;CACzE,OACE,oBAAC,UAAD;EAAQ,aAAU;EAAS,4CAAyC;EACjE;CACK,CAAA;AAEZ;;;;;;;AAQA,SAAgB,yBAAyB,EAAE,WAAW,GAAG,SAAwC;CAC/F,OAAO,oBAAC,QAAD;EAAM,GAAI;EAAO,eAAY;EAAkB;EAAW,uCAAoC;CAAI,CAAA;AAC3G"}
+{"version":3,"file":"account-entry-point.js","names":[],"sources":["../../../src/matter/account-entry-point/account-entry-point.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport { usePathname } from 'next/navigation';\nimport { type ComponentPropsWithRef, useEffect, useState } from 'react';\nimport { Icon } from '../../particles/icon/icon.js';\nimport { NavigationLink } from '../../particles/navigation-link/navigation-link.js';\nimport { resolveSignInHref } from '../../utils/safe-href.js';\nimport { useSession } from '../session/session.js';\n\n/** The account's root. A fixed convention, never an authored value: an authored destination could\n *  misroute the entry into the account. */\nconst ACCOUNT_ROUTE = '/account';\n\n// Nothing is required: an entry may author any subset, and a slice missing a required property is\n// shape-invalid, which drops the whole element rather than the one field.\nexport const AccountEntryPointContent = defineContentType({\n  id: 'account-entry-point',\n  title: 'Account Entry Point',\n  description: 'Labels and icon for the header sign-in / account control.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      signedOutLabel: { type: 'string', minLength: 1, title: 'Signed-out label' },\n      signedInLabel: { type: 'string', minLength: 1, title: 'Signed-in label' },\n      icon: { type: 'string', minLength: 1, title: 'Icon' },\n      loadingLabel: { type: 'string', minLength: 1, title: 'Loading announcement' },\n    },\n  },\n});\n\n/** Props for {@link AccountEntryPoint}. Extends native `<a>` attributes (the rendered root). */\nexport type AccountEntryPointProps = Omit<ComponentPropsWithRef<'a'>, 'href' | 'children'> & {\n  /** Label for anonymous and identified shoppers. Optional: the render gate, not the type,\n   *  requires a resolved value. */\n  signedOutLabel?: string;\n  /** Label for logged-in shoppers. Same gate. */\n  signedInLabel?: string;\n  /** Icon reference for the glyph. Never gated: a control with no glyph is a valid configuration. */\n  icon?: string;\n  /** Text the live region announces while the session resolves. */\n  loadingLabel?: string;\n  /** Merchant-authored fields, sliced from the page/layout content entry; win over the props field\n   *  by field when present. Absent in a non-CMS store — the props are the fallback. */\n  $content?: ContentValue<typeof AccountEntryPointContent>;\n};\n\n/** Props for {@link AccountEntryPointLoading}. Extends native `<span>` attributes. */\nexport type AccountEntryPointLoadingProps = Omit<ComponentPropsWithRef<'span'>, 'children'>;\n\nexport const AccountEntryPointDefinition = defineComponent<AccountEntryPointProps>({\n  name: 'AccountEntryPoint',\n  importPath: '@vtex/faststore/components',\n  component: AccountEntryPoint,\n  content: AccountEntryPointContent,\n  editor: { label: 'Account Entry Point', category: 'identity' },\n  requiresContext: 'session',\n  schema: {\n    signedOutLabel: { type: 'string', label: 'Signed-out Label' },\n    signedInLabel: { type: 'string', label: 'Signed-in Label' },\n    icon: { type: 'icon', label: 'Icon' },\n    loadingLabel: { type: 'string', label: 'Loading Announcement' },\n  },\n  guideline:\n    'Session-aware header control rendering one link: the signed-out label toward /login for anonymous and identified shoppers, the signed-in label toward the account route for logged-in ones, and a politely announced placeholder while the session resolves. Both destinations are fixed conventions, not props, so no authored value can misroute the auth flow. Must be inside a SessionRoot, normally the one hosted by the shared layout; a page-hosted provider also works, since the server-side session fetch forwards the shopper cookie. Author the label for a state or that state renders nothing; the labels are optional in the type only because a CMS entry may supply them, and an entry overrides all four fields at runtime. Style it through data-fs-account-entry-point and switch on data-fs-account-entry-point-state.',\n});\n\nexport function AccountEntryPoint({\n  signedOutLabel,\n  signedInLabel,\n  icon,\n  loadingLabel,\n  $content,\n  className,\n  ref,\n  ...props\n}: AccountEntryPointProps) {\n  const { state, loading } = useSession();\n  const pathname = usePathname();\n\n  // Blank entry fields fall through, so clearing one in the Admin reads as unauthored.\n  const entrySignedOutLabel = $content?.signedOutLabel?.trim() ? $content.signedOutLabel : signedOutLabel;\n  const entrySignedInLabel = $content?.signedInLabel?.trim() ? $content.signedInLabel : signedInLabel;\n  const entryIcon = $content?.icon?.trim() ? $content.icon : icon;\n  const entryLoadingLabel = $content?.loadingLabel?.trim() ? $content.loadingLabel : loadingLabel;\n\n  // Assistive technology only reports a change inside a region that was already in the tree, so a\n  // region mounted together with its text announces nothing. The region therefore holds the same\n  // position in both branches — React keeps it mounted across the swap — and starts empty, with the\n  // label written on the pass after mount and cleared again once the session resolves.\n  //\n  // It trails the branch content rather than leading it so the authored swatch, which lands on\n  // whichever element leads, can still reach the region through a following-sibling selector.\n  const [announcement, setAnnouncement] = useState('');\n  const resolvingLabel = loading ? entryLoadingLabel : undefined;\n  useEffect(() => {\n    setAnnouncement(resolvingLabel ?? '');\n  }, [resolvingLabel]);\n\n  // Gate on `loading` before `state`: an unresolved session reports `anonymous`, so reading the\n  // tri-state first would flash \"Sign In\" at a shopper who is already signed in.\n  if (loading) {\n    return (\n      <>\n        <AccountEntryPointLoading {...props} className={className} />\n        <AccountEntryPointAnnouncement>{announcement}</AccountEntryPointAnnouncement>\n      </>\n    );\n  }\n\n  // `identified` stays on the signed-out link: an identified but unauthenticated shopper cannot\n  // reach their account yet.\n  const signedIn = state === 'loggedIn';\n  const label = signedIn ? entrySignedInLabel : entrySignedOutLabel;\n\n  // A focusable link a screen reader announces as its bare URL is worse than no control at all.\n  if (!label?.trim()) {\n    return null;\n  }\n\n  return (\n    <>\n      <NavigationLink\n        {...props}\n        ref={ref}\n        href={signedIn ? ACCOUNT_ROUTE : resolveSignInHref(pathname)}\n        // The signed-out destination is a deferred auth proxy that may set a cookie or redirect, and\n        // a header control is always in the viewport — the default prefetch would fire that GET on\n        // every page view. The account route is an ordinary page, so it keeps the default.\n        prefetch={signedIn ? undefined : false}\n        className={className}\n        data-fs-account-entry-point=\"\"\n        data-fs-account-entry-point-state={signedIn ? 'signed-in' : 'signed-out'}\n      >\n        {entryIcon ? <Icon name={entryIcon} /> : null}\n        <span data-fs-account-entry-point-label=\"\">{label}</span>\n      </NavigationLink>\n      <AccountEntryPointAnnouncement>{announcement}</AccountEntryPointAnnouncement>\n    </>\n  );\n}\n\n/**\n * The live region that carries the control across the wait. Separate from the visual placeholder\n * because it has to outlive it: the placeholder is only in the tree while the session resolves,\n * while the region has to be there before the text lands for the text to be announced at all.\n */\nfunction AccountEntryPointAnnouncement({ children }: { children: string }) {\n  return (\n    <output aria-live=\"polite\" data-fs-account-entry-point-announcement=\"\">\n      {children}\n    </output>\n  );\n}\n\n/**\n * The visual stand-in occupying the control's slot while the session resolves. Purely visual: the\n * wait is spoken by the sibling live region, so this is hidden from assistive technology rather\n * than announced twice. Named for the state it represents, as `ShippingSimulatorLoading` is, not\n * for the bar it draws.\n */\nexport function AccountEntryPointLoading({ className, ...props }: AccountEntryPointLoadingProps) {\n  return <span {...props} aria-hidden=\"true\" className={className} data-fs-account-entry-point-loading=\"\" />;\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,gBAAgB;AAItB,MAAa,2BAA2B,kBAAkB;CACxD,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY;GACV,gBAAgB;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAmB;GAC1E,eAAe;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAkB;GACxE,MAAM;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAO;GACpD,cAAc;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAuB;EAC9E;CACF;AACF,CAAC;AAqBD,MAAa,8BAA8B,gBAAwC;CACjF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAuB,UAAU;CAAW;CAC7D,iBAAiB;CACjB,QAAQ;EACN,gBAAgB;GAAE,MAAM;GAAU,OAAO;EAAmB;EAC5D,eAAe;GAAE,MAAM;GAAU,OAAO;EAAkB;EAC1D,MAAM;GAAE,MAAM;GAAQ,OAAO;EAAO;EACpC,cAAc;GAAE,MAAM;GAAU,OAAO;EAAuB;CAChE;CACA,WACE;AACJ,CAAC;AAED,SAAgB,kBAAkB,EAChC,gBACA,eACA,MACA,cACA,UACA,WACA,KACA,GAAG,SACsB;CACzB,MAAM,EAAE,OAAO,YAAY,WAAW;CACtC,MAAM,WAAW,YAAY;CAG7B,MAAM,sBAAsB,UAAU,gBAAgB,KAAK,IAAI,SAAS,iBAAiB;CACzF,MAAM,qBAAqB,UAAU,eAAe,KAAK,IAAI,SAAS,gBAAgB;CACtF,MAAM,YAAY,UAAU,MAAM,KAAK,IAAI,SAAS,OAAO;CAC3D,MAAM,oBAAoB,UAAU,cAAc,KAAK,IAAI,SAAS,eAAe;CASnF,MAAM,CAAC,cAAc,mBAAmB,SAAS,EAAE;CACnD,MAAM,iBAAiB,UAAU,oBAAoB,KAAA;CACrD,gBAAgB;EACd,gBAAgB,kBAAkB,EAAE;CACtC,GAAG,CAAC,cAAc,CAAC;CAInB,IAAI,SACF,OACE,qBAAA,UAAA,EAAA,UAAA,CACE,oBAAC,0BAAD;EAA0B,GAAI;EAAkB;CAAY,CAAA,GAC5D,oBAAC,+BAAD,EAAA,UAAgC,aAA4C,CAAA,CAC5E,EAAA,CAAA;CAMN,MAAM,WAAW,UAAU;CAC3B,MAAM,QAAQ,WAAW,qBAAqB;CAG9C,IAAI,CAAC,OAAO,KAAK,GACf,OAAO;CAGT,OACE,qBAAA,UAAA,EAAA,UAAA,CACE,qBAAC,gBAAD;EACE,GAAI;EACC;EACL,MAAM,WAAW,gBAAgB,kBAAkB,QAAQ;EAI3D,UAAU,WAAW,KAAA,IAAY;EACtB;EACX,+BAA4B;EAC5B,qCAAmC,WAAW,cAAc;EAV9D,UAAA,CAYG,YAAY,oBAAC,MAAD,EAAM,MAAM,UAAY,CAAA,IAAI,MACzC,oBAAC,QAAD;GAAM,qCAAkC;GAAI,UAAA;EAAY,CAAA,CAC1C;CAChB,CAAA,GAAA,oBAAC,+BAAD,EAAA,UAAgC,aAA4C,CAAA,CAC5E,EAAA,CAAA;AAEN;;;;;;AAOA,SAAS,8BAA8B,EAAE,YAAkC;CACzE,OACE,oBAAC,UAAD;EAAQ,aAAU;EAAS,4CAAyC;EACjE;CACK,CAAA;AAEZ;;;;;;;AAQA,SAAgB,yBAAyB,EAAE,WAAW,GAAG,SAAwC;CAC/F,OAAO,oBAAC,QAAD;EAAM,GAAI;EAAO,eAAY;EAAkB;EAAW,uCAAoC;CAAI,CAAA;AAC3G"}

package/dist/matter/account-menu/account-menu.d.ts

@@ -0,0 +1,88 @@
+import { ContentValue } from "../../core/dist/define-content-type.js";
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/account-menu/account-menu.d.ts
+export declare const AccountMenuContent: {
+  readonly id: "account-menu";
+  readonly title: "Account Menu";
+  readonly description: "The ordered list of the account's sections, editable without a deployment.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly items: {
+        readonly type: "array";
+        readonly title: "Sections";
+        readonly minItems: 1;
+        readonly items: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly required: readonly ["label", "href"];
+          readonly properties: {
+            readonly label: {
+              readonly type: "string";
+              readonly minLength: 1;
+              readonly title: "Label";
+            };
+            readonly href: {
+              readonly type: "string";
+              readonly minLength: 1;
+              readonly title: "URL";
+              readonly format: "uri-reference";
+              readonly pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$";
+            };
+            readonly external: {
+              readonly type: "boolean";
+              readonly title: "Leaves the account";
+            };
+          };
+        };
+      };
+    };
+  };
+};
+type AccountMenuContentValue = ContentValue<typeof AccountMenuContent>;
+/** One authored section. Derived from the model so the prop and content channels cannot drift. */
+export type AccountMenuSection = NonNullable<AccountMenuContentValue['items']>[number];
+/** A section resolved for render. A null `href` is a destination the allowlist refused. */
+export type AccountMenuResolvedSection = {
+  label: string;
+  href: string | null;
+  external: boolean;
+};
+export type AccountMenuCurrent = {
+  /** Index into the resolved list. */
+  index: number;
+  /** `exact` when the path is the section; `ancestor` when the shopper is inside it. */
+  match: 'exact' | 'ancestor';
+};
+export type AccountMenuContextValue = {
+  /** Resolved, in the merchant's order, with blank-label sections dropped. */
+  items: readonly AccountMenuResolvedSection[];
+  /** The current section, or null when the path matches none. */
+  current: AccountMenuCurrent | null;
+};
+export type AccountMenuRootProps = ComponentPropsWithRef<'div'> & {
+  /** Authored fallback for the section list, used when no CMS entry supplies one. */
+  items?: readonly AccountMenuSection[];
+  /** Injected by the compiler, sliced from the page's or layout's composite content entry. */
+  $content?: AccountMenuContentValue;
+};
+/** The landmark renders one item per section, so it takes no children. */
+export type AccountMenuListProps = Omit<ComponentPropsWithRef<'nav'>, 'children'> & {
+  /** Accessible name of the navigation landmark. */
+  label?: string;
+};
+export declare const AccountMenuRootDefinition: ComponentDefinition<AccountMenuRootProps>;
+export declare const AccountMenuListDefinition: ComponentDefinition<AccountMenuListProps>;
+/** The resolved section list and the current section. */
+export declare function useAccountMenu(): AccountMenuContextValue;
+export declare function AccountMenuRoot({ items, $content, className, children, ...props }: AccountMenuRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function AccountMenuList({ label, className, ...props }: AccountMenuListProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const AccountMenu: {
+  Root: typeof AccountMenuRoot;
+  List: typeof AccountMenuList;
+};
+//#endregion
+//# sourceMappingURL=account-menu.d.ts.map

package/dist/matter/account-menu/account-menu.js

@@ -0,0 +1,246 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { resolveSafeHref, resolveSiteRelativeHref } from "../../utils/safe-href.js";
+import { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
+import { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+import { usePathname } from "next/navigation";
+//#region src/matter/account-menu/account-menu.tsx
+const useIsomorphicLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+const AccountMenuContent = defineContentType({
+	id: "account-menu",
+	title: "Account Menu",
+	description: "The ordered list of the account's sections, editable without a deployment.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { items: {
+			type: "array",
+			title: "Sections",
+			minItems: 1,
+			items: {
+				type: "object",
+				additionalProperties: false,
+				required: ["label", "href"],
+				properties: {
+					label: {
+						type: "string",
+						minLength: 1,
+						title: "Label"
+					},
+					href: {
+						type: "string",
+						minLength: 1,
+						title: "URL",
+						format: "uri-reference",
+						pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$"
+					},
+					external: {
+						type: "boolean",
+						title: "Leaves the account"
+					}
+				}
+			}
+		} }
+	}
+});
+const AccountMenuRootDefinition = defineComponent({
+	name: "AccountMenuRoot",
+	importPath: "@vtex/faststore/components",
+	component: AccountMenuRoot,
+	content: AccountMenuContent,
+	providesContext: "account-menu",
+	editor: {
+		label: "Account Menu Root",
+		category: "navigation"
+	},
+	schema: { items: {
+		type: "array",
+		label: "Sections"
+	} },
+	guideline: "The account menu's provider, and deliberately not its landmark: it resolves the section list, derives which section the shopper is reading, publishes both, and renders its children. Compose it in the my-account layout around both AccountMenuList and the Slot holding the section's own page — its context has to reach the consumers inside the slot, and a nav stretched that far would announce every section's content as navigation. The list comes from a published entry, else the authored items prop, else the library's five defaults; a channel supplying an empty list resolves to empty rather than falling through, because a merchant who cleared the list cleared it. Style it through data-fs-account-menu."
+});
+const AccountMenuListDefinition = defineComponent({
+	name: "AccountMenuList",
+	importPath: "@vtex/faststore/components",
+	component: AccountMenuList,
+	requiresContext: "account-menu",
+	editor: {
+		label: "Account Menu List",
+		category: "navigation"
+	},
+	schema: { label: {
+		type: "string",
+		default: "Account",
+		label: "Aria Label"
+	} },
+	guideline: "The account menu's navigation landmark and its items, and nothing else — it surrounds the items alone so the section's own content stays outside the navigation region. Author the label: a landmark with no accessible name is one a screen-reader user cannot tell from any other. The current section carries aria-current, page for the section itself and true for a page inside it, with data-fs-account-menu-item-current beside it as a style target and never as the only signal. When the list scrolls, the current item is brought into view on mount and on every route change. Must be a descendant of AccountMenuRoot."
+});
+/**
+* The library's default set, the five sections the PRD names. Labels are English as an interim, until
+* the Localization cluster's catalog resolves them per locale. Their destinations only resolve in a
+* store that authored the account's route family.
+*/
+const DEFAULT_SECTIONS = [
+	{
+		label: "Profile",
+		href: "/account/profile"
+	},
+	{
+		label: "Orders",
+		href: "/account/orders"
+	},
+	{
+		label: "Address",
+		href: "/account/address"
+	},
+	{
+		label: "Payments",
+		href: "/account/payments"
+	},
+	{
+		label: "Security",
+		href: "/account/security"
+	}
+];
+function resolveSections(sections) {
+	const resolved = [];
+	sections.forEach((section, index) => {
+		if (section.label.trim().length === 0) return;
+		const destination = resolveSafeHref(section.href);
+		if (!destination.safe) console.warn("[AccountMenu] section destination rejected", {
+			index,
+			reason: destination.reason
+		});
+		resolved.push({
+			label: section.label,
+			href: destination.safe ? destination.href : null,
+			external: section.external ?? false
+		});
+	});
+	return resolved;
+}
+/** What a match runs against: no query, no hash, and no trailing slash except at the root. */
+function normalizePath(value) {
+	const separator = value.search(/[?#]/);
+	const trimmed = (separator === -1 ? value : value.slice(0, separator)).replace(/\/+$/, "");
+	return trimmed.length === 0 ? "/" : trimmed;
+}
+/**
+* The current section, matched on segment boundaries. Legacy matched by prefix and marked every
+* section whose path was a prefix of the current one; the longest match wins here, which keeps
+* exactly one section current and makes an exact match beat every ancestor without a second rule.
+*/
+function findCurrent(sections, pathname) {
+	if (pathname === null) return null;
+	const path = normalizePath(pathname);
+	let current = null;
+	let matchedLength = -1;
+	for (const [index, section] of sections.entries()) {
+		if (section.external || section.href === null || !resolveSiteRelativeHref(section.href).safe) continue;
+		const href = normalizePath(section.href);
+		if (href.length <= matchedLength) continue;
+		const exact = path === href;
+		const ancestor = href !== "/" && path.startsWith(`${href}/`);
+		if (!exact && !ancestor) continue;
+		current = {
+			index,
+			match: exact ? "exact" : "ancestor"
+		};
+		matchedLength = href.length;
+	}
+	return current;
+}
+/**
+* `page` for the section itself, `true` for a page inside it. The distinction is kept rather than
+* collapsed because the sibling breadcrumb names the deep page as the current one, and two surfaces
+* announcing "current page" for two different things is worse than the menu claiming only its set.
+*/
+function ariaCurrentFor(match) {
+	return match === "exact" ? "page" : "true";
+}
+function overflows(element) {
+	if (!element) return false;
+	return element.scrollWidth > element.clientWidth || element.scrollHeight > element.clientHeight;
+}
+const AccountMenuContext = createContext(null);
+/** The resolved section list and the current section. */
+function useAccountMenu() {
+	const value = useContext(AccountMenuContext);
+	if (!value) throw new Error("AccountMenu parts must be used inside AccountMenuRoot.");
+	return value;
+}
+function AccountMenuRoot({ items, $content, className, children, ...props }) {
+	const pathname = usePathname();
+	const sections = $content?.items ?? items ?? DEFAULT_SECTIONS;
+	const value = useMemo(() => {
+		const resolved = resolveSections(sections);
+		return {
+			items: resolved,
+			current: findCurrent(resolved, pathname)
+		};
+	}, [sections, pathname]);
+	return /* @__PURE__ */ jsx(AccountMenuContext, {
+		value,
+		children: /* @__PURE__ */ jsx("div", {
+			...props,
+			className,
+			"data-fs-account-menu": "",
+			children
+		})
+	});
+}
+function AccountMenuList({ label = "Account", className, ...props }) {
+	const { items, current } = useAccountMenu();
+	const currentRef = useRef(null);
+	const currentIndex = current?.index ?? null;
+	useIsomorphicLayoutEffect(() => {
+		if (currentIndex === null) return;
+		const item = currentRef.current;
+		if (!item || typeof item.scrollIntoView !== "function") return;
+		const list = item.parentElement;
+		if (!overflows(list) && !overflows(list?.parentElement)) return;
+		item.scrollIntoView({
+			block: "nearest",
+			inline: "nearest"
+		});
+	}, [currentIndex]);
+	if (items.length === 0) return null;
+	return /* @__PURE__ */ jsx("nav", {
+		...props,
+		"aria-label": label,
+		className,
+		"data-fs-account-menu-list": "",
+		children: /* @__PURE__ */ jsx("ul", {
+			"data-fs-account-menu-items": "",
+			children: items.map((item, index) => {
+				const isCurrent = index === currentIndex;
+				return /* @__PURE__ */ jsx("li", {
+					ref: isCurrent ? currentRef : null,
+					"data-fs-account-menu-item": "",
+					"data-fs-account-menu-item-current": isCurrent ? "" : void 0,
+					children: item.href === null ? /* @__PURE__ */ jsx("span", {
+						"data-fs-text": "",
+						"data-fs-account-menu-text": "",
+						children: item.label
+					}) : /* @__PURE__ */ jsx(NavigationLink, {
+						href: item.href,
+						"aria-current": current && isCurrent ? ariaCurrentFor(current.match) : void 0,
+						"data-fs-account-menu-link": "",
+						children: item.label
+					})
+				}, index);
+			})
+		})
+	});
+}
+const AccountMenu = {
+	Root: AccountMenuRoot,
+	List: AccountMenuList
+};
+//#endregion
+export { AccountMenu, AccountMenuContent, AccountMenuList, AccountMenuListDefinition, AccountMenuRoot, AccountMenuRootDefinition, useAccountMenu };
+
+//# sourceMappingURL=account-menu.js.map

package/dist/matter/account-menu/account-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-menu.js","names":[],"sources":["../../../src/matter/account-menu/account-menu.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport { usePathname } from 'next/navigation';\nimport {\n  type ComponentPropsWithRef,\n  createContext,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n} from 'react';\nimport { NavigationLink } from '../../particles/navigation-link/navigation-link.js';\nimport { resolveSafeHref, resolveSiteRelativeHref } from '../../utils/safe-href.js';\n\n// The scroll has to land before paint, or the list shows its top for a frame and then jumps.\n// `useEffect` on the server silences React 19's \"useLayoutEffect does nothing on the server\", as\n// `matter/variant-selector` does for its own pre-paint measurement.\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\n// ---------------------------------------------------------------------------\n// Content model\n// ---------------------------------------------------------------------------\n\nexport const AccountMenuContent = defineContentType({\n  id: 'account-menu',\n  title: 'Account Menu',\n  description: \"The ordered list of the account's sections, editable without a deployment.\",\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    // `items` is not required, for the reason NavigationLinkList records: a missing element key\n    // already omits the component, so requiring it would only cost the prop fallback its shape\n    // validity.\n    properties: {\n      items: {\n        type: 'array',\n        title: 'Sections',\n        minItems: 1,\n        items: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['label', 'href'],\n          properties: {\n            label: { type: 'string', minLength: 1, title: 'Label' },\n            href: {\n              type: 'string',\n              minLength: 1,\n              title: 'URL',\n              format: 'uri-reference',\n              // Author-time guidance only, and lookahead-free so the Admin's RE2-family engine takes it.\n              pattern: '^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$',\n            },\n            external: { type: 'boolean', title: 'Leaves the account' },\n          },\n        },\n      },\n    },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype AccountMenuContentValue = ContentValue<typeof AccountMenuContent>;\n\n/** One authored section. Derived from the model so the prop and content channels cannot drift. */\nexport type AccountMenuSection = NonNullable<AccountMenuContentValue['items']>[number];\n\n/** A section resolved for render. A null `href` is a destination the allowlist refused. */\nexport type AccountMenuResolvedSection = {\n  label: string;\n  href: string | null;\n  external: boolean;\n};\n\nexport type AccountMenuCurrent = {\n  /** Index into the resolved list. */\n  index: number;\n  /** `exact` when the path is the section; `ancestor` when the shopper is inside it. */\n  match: 'exact' | 'ancestor';\n};\n\nexport type AccountMenuContextValue = {\n  /** Resolved, in the merchant's order, with blank-label sections dropped. */\n  items: readonly AccountMenuResolvedSection[];\n  /** The current section, or null when the path matches none. */\n  current: AccountMenuCurrent | null;\n};\n\nexport type AccountMenuRootProps = ComponentPropsWithRef<'div'> & {\n  /** Authored fallback for the section list, used when no CMS entry supplies one. */\n  items?: readonly AccountMenuSection[];\n  /** Injected by the compiler, sliced from the page's or layout's composite content entry. */\n  $content?: AccountMenuContentValue;\n};\n\n/** The landmark renders one item per section, so it takes no children. */\nexport type AccountMenuListProps = Omit<ComponentPropsWithRef<'nav'>, 'children'> & {\n  /** Accessible name of the navigation landmark. */\n  label?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const AccountMenuRootDefinition = defineComponent<AccountMenuRootProps>({\n  name: 'AccountMenuRoot',\n  importPath: '@vtex/faststore/components',\n  component: AccountMenuRoot,\n  content: AccountMenuContent,\n  providesContext: 'account-menu',\n  editor: { label: 'Account Menu Root', category: 'navigation' },\n  schema: {\n    items: { type: 'array', label: 'Sections' },\n  },\n  guideline:\n    \"The account menu's provider, and deliberately not its landmark: it resolves the section list, derives which section the shopper is reading, publishes both, and renders its children. Compose it in the my-account layout around both AccountMenuList and the Slot holding the section's own page — its context has to reach the consumers inside the slot, and a nav stretched that far would announce every section's content as navigation. The list comes from a published entry, else the authored items prop, else the library's five defaults; a channel supplying an empty list resolves to empty rather than falling through, because a merchant who cleared the list cleared it. Style it through data-fs-account-menu.\",\n});\n\nexport const AccountMenuListDefinition = defineComponent<AccountMenuListProps>({\n  name: 'AccountMenuList',\n  importPath: '@vtex/faststore/components',\n  component: AccountMenuList,\n  requiresContext: 'account-menu',\n  editor: { label: 'Account Menu List', category: 'navigation' },\n  schema: {\n    label: { type: 'string', default: 'Account', label: 'Aria Label' },\n  },\n  guideline:\n    \"The account menu's navigation landmark and its items, and nothing else — it surrounds the items alone so the section's own content stays outside the navigation region. Author the label: a landmark with no accessible name is one a screen-reader user cannot tell from any other. The current section carries aria-current, page for the section itself and true for a page inside it, with data-fs-account-menu-item-current beside it as a style target and never as the only signal. When the list scrolls, the current item is brought into view on mount and on every route change. Must be a descendant of AccountMenuRoot.\",\n});\n\n// ---------------------------------------------------------------------------\n// Resolution\n// ---------------------------------------------------------------------------\n\n/**\n * The library's default set, the five sections the PRD names. Labels are English as an interim, until\n * the Localization cluster's catalog resolves them per locale. Their destinations only resolve in a\n * store that authored the account's route family.\n */\nconst DEFAULT_SECTIONS: readonly AccountMenuSection[] = [\n  { label: 'Profile', href: '/account/profile' },\n  { label: 'Orders', href: '/account/orders' },\n  { label: 'Address', href: '/account/address' },\n  { label: 'Payments', href: '/account/payments' },\n  { label: 'Security', href: '/account/security' },\n];\n\nfunction resolveSections(sections: readonly AccountMenuSection[]): AccountMenuResolvedSection[] {\n  const resolved: AccountMenuResolvedSection[] = [];\n\n  sections.forEach((section, index) => {\n    // `minLength` is enforced by neither the runtime slice nor the preflight, so a blank label\n    // reaches the component. Drop the section: an anchor with no accessible name is a WCAG failure.\n    if (section.label.trim().length === 0) {\n      return;\n    }\n    const destination = resolveSafeHref(section.href);\n    if (!destination.safe) {\n      console.warn('[AccountMenu] section destination rejected', { index, reason: destination.reason });\n    }\n    resolved.push({\n      label: section.label,\n      href: destination.safe ? destination.href : null,\n      external: section.external ?? false,\n    });\n  });\n\n  return resolved;\n}\n\n/** What a match runs against: no query, no hash, and no trailing slash except at the root. */\nfunction normalizePath(value: string): string {\n  const separator = value.search(/[?#]/);\n  const path = separator === -1 ? value : value.slice(0, separator);\n  const trimmed = path.replace(/\\/+$/, '');\n  return trimmed.length === 0 ? '/' : trimmed;\n}\n\n/**\n * The current section, matched on segment boundaries. Legacy matched by prefix and marked every\n * section whose path was a prefix of the current one; the longest match wins here, which keeps\n * exactly one section current and makes an exact match beat every ancestor without a second rule.\n */\nfunction findCurrent(\n  sections: readonly AccountMenuResolvedSection[],\n  pathname: string | null,\n): AccountMenuCurrent | null {\n  if (pathname === null) {\n    return null;\n  }\n\n  const path = normalizePath(pathname);\n  let current: AccountMenuCurrent | null = null;\n  let matchedLength = -1;\n\n  for (const [index, section] of sections.entries()) {\n    // An external section leaves the account and is outside the current-section contract, and an\n    // absolute destination could never be a path in the first place.\n    if (section.external || section.href === null || !resolveSiteRelativeHref(section.href).safe) {\n      continue;\n    }\n    const href = normalizePath(section.href);\n    if (href.length <= matchedLength) {\n      continue;\n    }\n    // A root href is an ancestor of every account path, so a merchant listing the storefront's home\n    // beside the sections would otherwise see it current on every page. It matches exactly or not at all.\n    const exact = path === href;\n    const ancestor = href !== '/' && path.startsWith(`${href}/`);\n    if (!exact && !ancestor) {\n      continue;\n    }\n    current = { index, match: exact ? 'exact' : 'ancestor' };\n    matchedLength = href.length;\n  }\n\n  return current;\n}\n\n/**\n * `page` for the section itself, `true` for a page inside it. The distinction is kept rather than\n * collapsed because the sibling breadcrumb names the deep page as the current one, and two surfaces\n * announcing \"current page\" for two different things is worse than the menu claiming only its set.\n */\nfunction ariaCurrentFor(match: AccountMenuCurrent['match']): 'page' | 'true' {\n  return match === 'exact' ? 'page' : 'true';\n}\n\nfunction overflows(element: Element | null | undefined): boolean {\n  if (!element) {\n    return false;\n  }\n  return element.scrollWidth > element.clientWidth || element.scrollHeight > element.clientHeight;\n}\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst AccountMenuContext = createContext<AccountMenuContextValue | null>(null);\n\n/** The resolved section list and the current section. */\nexport function useAccountMenu(): AccountMenuContextValue {\n  const value = useContext(AccountMenuContext);\n  if (!value) {\n    throw new Error('AccountMenu parts must be used inside AccountMenuRoot.');\n  }\n  return value;\n}\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function AccountMenuRoot({ items, $content, className, children, ...props }: AccountMenuRootProps) {\n  const pathname = usePathname();\n  // Presence decides, not truthiness: a channel supplying an empty list resolves to empty rather than\n  // falling through, so the defaults never override a list the merchant published deliberately.\n  // `minItems` guides the Admin form only, so that empty list still reaches this component.\n  const sections = $content?.items ?? items ?? DEFAULT_SECTIONS;\n\n  const value = useMemo<AccountMenuContextValue>(() => {\n    const resolved = resolveSections(sections);\n    return { items: resolved, current: findCurrent(resolved, pathname) };\n  }, [sections, pathname]);\n\n  return (\n    <AccountMenuContext value={value}>\n      <div {...props} className={className} data-fs-account-menu=\"\">\n        {children}\n      </div>\n    </AccountMenuContext>\n  );\n}\n\nexport function AccountMenuList({ label = 'Account', className, ...props }: AccountMenuListProps) {\n  const { items, current } = useAccountMenu();\n  const currentRef = useRef<HTMLLIElement>(null);\n  const currentIndex = current?.index ?? null;\n\n  useIsomorphicLayoutEffect(() => {\n    if (currentIndex === null) {\n      return;\n    }\n    const item = currentRef.current;\n    if (!item || typeof item.scrollIntoView !== 'function') {\n      return;\n    }\n    // Only when the row actually scrolls. An unconditional call scrolls whatever ancestor can move,\n    // which on a menu that fits is the page. The containers are the item's `ul` and its `nav`.\n    const list = item.parentElement;\n    if (!overflows(list) && !overflows(list?.parentElement)) {\n      return;\n    }\n    // `nearest` on both axes is a no-op once the item is visible, so a route change inside the\n    // current section does not jolt the row.\n    item.scrollIntoView({ block: 'nearest', inline: 'nearest' });\n  }, [currentIndex]);\n\n  if (items.length === 0) {\n    return null;\n  }\n\n  return (\n    <nav {...props} aria-label={label} className={className} data-fs-account-menu-list=\"\">\n      <ul data-fs-account-menu-items=\"\">\n        {items.map((item, index) => {\n          const isCurrent = index === currentIndex;\n          return (\n            <li\n              key={index}\n              ref={isCurrent ? currentRef : null}\n              data-fs-account-menu-item=\"\"\n              data-fs-account-menu-item-current={isCurrent ? '' : undefined}\n            >\n              {item.href === null ? (\n                <span data-fs-text=\"\" data-fs-account-menu-text=\"\">\n                  {item.label}\n                </span>\n              ) : (\n                <NavigationLink\n                  href={item.href}\n                  aria-current={current && isCurrent ? ariaCurrentFor(current.match) : undefined}\n                  data-fs-account-menu-link=\"\"\n                >\n                  {item.label}\n                </NavigationLink>\n              )}\n            </li>\n          );\n        })}\n      </ul>\n    </nav>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace export\n// ---------------------------------------------------------------------------\n\nexport const AccountMenu = {\n  Root: AccountMenuRoot,\n  List: AccountMenuList,\n};\n"],"mappings":"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"}