@vtex/faststore 0.0.4 → 0.0.5

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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"}

package/dist/matter/cart/cart.d.ts

@@ -149,7 +149,7 @@ export declare const CartDataContext: React.Context<CartDataContextValue>;
  *
  * Cart *writes* no longer flow through this context — they are dispatched via the compiler-injected
  * `$actions.cart.*` prop (the `cart` action namespace), which reads/writes the cache directly and
- * needs no `CartRoot` ancestor (specs/actions.md, ADR-0010). This hook is reads only.
+ * needs no `CartRoot` ancestor (docs/storefront-core/reference-free-particle-model.md § Write side — actions, ADR-0010). This hook is reads only.
  */
 export declare function useCart(): CartDataContextValue;
 export declare const CartRootDefinition: ComponentDefinition<CartRootProps>;

package/dist/matter/cart/cart.js

@@ -6,8 +6,8 @@ import { useStorefrontContext } from "../../sdk/context/storefront-context.js";
 import { graphql } from "../../sdk/generated/gql.js";
 import { useActionsOverride } from "../../sdk/actions/actions-override-context.js";
 import { useDataOverride } from "../../sdk/data/data-override-context.js";
-import { Icon } from "../../particles/icon/icon.js";
 import { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
+import { Icon } from "../../particles/icon/icon.js";
 import { DrawerClose } from "../../particles/drawer/drawer.js";
 import { Image } from "../../particles/image/image.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../../sdk/state/cart.js";
@@ -107,7 +107,7 @@ const CartDataContext = CartDataContextInternal;
 *
 * Cart *writes* no longer flow through this context — they are dispatched via the compiler-injected
 * `$actions.cart.*` prop (the `cart` action namespace), which reads/writes the cache directly and
-* needs no `CartRoot` ancestor (specs/actions.md, ADR-0010). This hook is reads only.
+* needs no `CartRoot` ancestor (docs/storefront-core/reference-free-particle-model.md § Write side — actions, ADR-0010). This hook is reads only.
 */
 function useCart() {
 	const ctx = useContext(CartDataContextInternal);