@vtex/faststore 0.0.1

package/dist/particles/meter/meter.js

@@ -0,0 +1,132 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { jsx } from "react/jsx-runtime";
+import { Meter } from "@base-ui/react/meter";
+//#region src/particles/meter/meter.tsx
+const MeterRootDefinition = defineComponent({
+	name: "MeterRoot",
+	importPath: "@vtex/faststore/components",
+	component: MeterRoot,
+	editor: {
+		label: "Meter Root",
+		category: "content"
+	},
+	schema: {
+		value: {
+			type: "number",
+			default: 0,
+			label: "Value"
+		},
+		min: {
+			type: "number",
+			default: 0,
+			label: "Min"
+		},
+		max: {
+			type: "number",
+			default: 100,
+			label: "Max"
+		}
+	},
+	guideline: "Determinate meter bar showing a value along a known range (ARIA role=\"meter\"). Wrap a MeterTrack + MeterIndicator; optionally a MeterLabel and MeterValue. See meter.md."
+});
+const MeterTrackDefinition = defineComponent({
+	name: "MeterTrack",
+	importPath: "@vtex/faststore/components",
+	component: MeterTrack,
+	editor: {
+		label: "Meter Track",
+		category: "content"
+	},
+	schema: {},
+	guideline: "The full-range groove of the meter. Direct child of MeterRoot; wraps MeterIndicator. See meter.md."
+});
+const MeterIndicatorDefinition = defineComponent({
+	name: "MeterIndicator",
+	importPath: "@vtex/faststore/components",
+	component: MeterIndicator,
+	editor: {
+		label: "Meter Indicator",
+		category: "content"
+	},
+	schema: {},
+	guideline: "The filled portion of the meter; Base UI sizes it to the value. Direct child of MeterTrack. See meter.md."
+});
+const MeterLabelDefinition = defineComponent({
+	name: "MeterLabel",
+	importPath: "@vtex/faststore/components",
+	component: MeterLabel,
+	editor: {
+		label: "Meter Label",
+		category: "content"
+	},
+	schema: {},
+	guideline: "Accessible text label for the meter. Child of MeterRoot. See meter.md."
+});
+const MeterValueDefinition = defineComponent({
+	name: "MeterValue",
+	importPath: "@vtex/faststore/components",
+	component: MeterValue,
+	editor: {
+		label: "Meter Value",
+		category: "content"
+	},
+	schema: {},
+	guideline: "Renders the current value as text. Child of MeterRoot. See meter.md."
+});
+function MeterRoot({ value, min = 0, max = 100, locale, getAriaValueText, className, children, ...props }) {
+	return /* @__PURE__ */ jsx(Meter.Root, {
+		...props,
+		value,
+		min,
+		max,
+		locale,
+		getAriaValueText,
+		className,
+		"data-fs-meter-root": "",
+		children
+	});
+}
+function MeterTrack({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(Meter.Track, {
+		...props,
+		className,
+		"data-fs-meter-track": "",
+		children
+	});
+}
+function MeterIndicator({ className, ...props }) {
+	return /* @__PURE__ */ jsx(Meter.Indicator, {
+		...props,
+		className,
+		"data-fs-meter-indicator": ""
+	});
+}
+function MeterLabel({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(Meter.Label, {
+		...props,
+		className,
+		"data-fs-meter-label": "",
+		children
+	});
+}
+function MeterValue({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(Meter.Value, {
+		...props,
+		className,
+		"data-fs-meter-value": "",
+		children
+	});
+}
+const Meter$1 = {
+	Root: MeterRoot,
+	Track: MeterTrack,
+	Indicator: MeterIndicator,
+	Label: MeterLabel,
+	Value: MeterValue
+};
+//#endregion
+export { Meter$1 as Meter, MeterIndicator, MeterIndicatorDefinition, MeterLabel, MeterLabelDefinition, MeterRoot, MeterRootDefinition, MeterTrack, MeterTrackDefinition, MeterValue, MeterValueDefinition };
+
+//# sourceMappingURL=meter.js.map

package/dist/particles/meter/meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.js","names":["BaseMeter","Meter"],"sources":["../../../src/particles/meter/meter.tsx"],"sourcesContent":["'use client';\n\nimport { Meter as BaseMeter } from '@base-ui/react/meter';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef, ReactNode } from 'react';\n\nexport type MeterRootProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue'> & {\n  value: number;\n  min?: number;\n  max?: number;\n  locale?: string;\n  getAriaValueText?: (formattedValue: string, value: number) => string;\n};\n\nexport type MeterTrackProps = ComponentPropsWithRef<'div'>;\nexport type MeterIndicatorProps = ComponentPropsWithRef<'div'>;\nexport type MeterLabelProps = ComponentPropsWithRef<'span'>;\nexport type MeterValueProps = Omit<ComponentPropsWithRef<'span'>, 'children'> & {\n  children?: (formattedValue: string, value: number) => ReactNode;\n};\n\nexport const MeterRootDefinition = defineComponent<MeterRootProps>({\n  name: 'MeterRoot',\n  importPath: '@vtex/faststore/components',\n  component: MeterRoot,\n  editor: { label: 'Meter Root', category: 'content' },\n  schema: {\n    value: { type: 'number', default: 0, label: 'Value' },\n    min: { type: 'number', default: 0, label: 'Min' },\n    max: { type: 'number', default: 100, label: 'Max' },\n  },\n  guideline:\n    'Determinate meter bar showing a value along a known range (ARIA role=\"meter\"). Wrap a MeterTrack + MeterIndicator; optionally a MeterLabel and MeterValue. See meter.md.',\n});\n\nexport const MeterTrackDefinition = defineComponent<MeterTrackProps>({\n  name: 'MeterTrack',\n  importPath: '@vtex/faststore/components',\n  component: MeterTrack,\n  editor: { label: 'Meter Track', category: 'content' },\n  schema: {},\n  guideline: 'The full-range groove of the meter. Direct child of MeterRoot; wraps MeterIndicator. See meter.md.',\n});\n\nexport const MeterIndicatorDefinition = defineComponent<MeterIndicatorProps>({\n  name: 'MeterIndicator',\n  importPath: '@vtex/faststore/components',\n  component: MeterIndicator,\n  editor: { label: 'Meter Indicator', category: 'content' },\n  schema: {},\n  guideline:\n    'The filled portion of the meter; Base UI sizes it to the value. Direct child of MeterTrack. See meter.md.',\n});\n\nexport const MeterLabelDefinition = defineComponent<MeterLabelProps>({\n  name: 'MeterLabel',\n  importPath: '@vtex/faststore/components',\n  component: MeterLabel,\n  editor: { label: 'Meter Label', category: 'content' },\n  schema: {},\n  guideline: 'Accessible text label for the meter. Child of MeterRoot. See meter.md.',\n});\n\nexport const MeterValueDefinition = defineComponent<MeterValueProps>({\n  name: 'MeterValue',\n  importPath: '@vtex/faststore/components',\n  component: MeterValue,\n  editor: { label: 'Meter Value', category: 'content' },\n  schema: {},\n  guideline: 'Renders the current value as text. Child of MeterRoot. See meter.md.',\n});\n\nexport function MeterRoot({\n  value,\n  min = 0,\n  max = 100,\n  locale,\n  getAriaValueText,\n  className,\n  children,\n  ...props\n}: MeterRootProps) {\n  return (\n    <BaseMeter.Root\n      {...props}\n      value={value}\n      min={min}\n      max={max}\n      locale={locale}\n      getAriaValueText={getAriaValueText}\n      className={className}\n      data-fs-meter-root=\"\"\n    >\n      {children}\n    </BaseMeter.Root>\n  );\n}\n\nexport function MeterTrack({ className, children, ...props }: MeterTrackProps) {\n  return (\n    <BaseMeter.Track {...props} className={className} data-fs-meter-track=\"\">\n      {children}\n    </BaseMeter.Track>\n  );\n}\n\nexport function MeterIndicator({ className, ...props }: MeterIndicatorProps) {\n  return <BaseMeter.Indicator {...props} className={className} data-fs-meter-indicator=\"\" />;\n}\n\nexport function MeterLabel({ className, children, ...props }: MeterLabelProps) {\n  return (\n    <BaseMeter.Label {...props} className={className} data-fs-meter-label=\"\">\n      {children}\n    </BaseMeter.Label>\n  );\n}\n\nexport function MeterValue({ className, children, ...props }: MeterValueProps) {\n  return (\n    <BaseMeter.Value {...props} className={className} data-fs-meter-value=\"\">\n      {children}\n    </BaseMeter.Value>\n  );\n}\n\nexport const Meter = {\n  Root: MeterRoot,\n  Track: MeterTrack,\n  Indicator: MeterIndicator,\n  Label: MeterLabel,\n  Value: MeterValue,\n};\n"],"mappings":";;;;;;AAqBA,MAAa,sBAAsB,gBAAgC;CACjE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAc,UAAU;CAAU;CACnD,QAAQ;EACN,OAAO;GAAE,MAAM;GAAU,SAAS;GAAG,OAAO;EAAQ;EACpD,KAAK;GAAE,MAAM;GAAU,SAAS;GAAG,OAAO;EAAM;EAChD,KAAK;GAAE,MAAM;GAAU,SAAS;GAAK,OAAO;EAAM;CACpD;CACA,WACE;AACJ,CAAC;AAED,MAAa,uBAAuB,gBAAiC;CACnE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAe,UAAU;CAAU;CACpD,QAAQ,CAAC;CACT,WAAW;AACb,CAAC;AAED,MAAa,2BAA2B,gBAAqC;CAC3E,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAmB,UAAU;CAAU;CACxD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,uBAAuB,gBAAiC;CACnE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAe,UAAU;CAAU;CACpD,QAAQ,CAAC;CACT,WAAW;AACb,CAAC;AAED,MAAa,uBAAuB,gBAAiC;CACnE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAe,UAAU;CAAU;CACpD,QAAQ,CAAC;CACT,WAAW;AACb,CAAC;AAED,SAAgB,UAAU,EACxB,OACA,MAAM,GACN,MAAM,KACN,QACA,kBACA,WACA,UACA,GAAG,SACc;CACjB,OACE,oBAACA,MAAU,MAAX;EACE,GAAI;EACG;EACF;EACA;EACG;EACU;EACP;EACX,sBAAmB;EAElB;CACa,CAAA;AAEpB;AAEA,SAAgB,WAAW,EAAE,WAAW,UAAU,GAAG,SAA0B;CAC7E,OACE,oBAACA,MAAU,OAAX;EAAiB,GAAI;EAAkB;EAAW,uBAAoB;EACnE;CACc,CAAA;AAErB;AAEA,SAAgB,eAAe,EAAE,WAAW,GAAG,SAA8B;CAC3E,OAAO,oBAACA,MAAU,WAAX;EAAqB,GAAI;EAAkB;EAAW,2BAAwB;CAAI,CAAA;AAC3F;AAEA,SAAgB,WAAW,EAAE,WAAW,UAAU,GAAG,SAA0B;CAC7E,OACE,oBAACA,MAAU,OAAX;EAAiB,GAAI;EAAkB;EAAW,uBAAoB;EACnE;CACc,CAAA;AAErB;AAEA,SAAgB,WAAW,EAAE,WAAW,UAAU,GAAG,SAA0B;CAC7E,OACE,oBAACA,MAAU,OAAX;EAAiB,GAAI;EAAkB;EAAW,uBAAoB;EACnE;CACc,CAAA;AAErB;AAEA,MAAaC,UAAQ;CACnB,MAAM;CACN,OAAO;CACP,WAAW;CACX,OAAO;CACP,OAAO;AACT"}

package/dist/particles/navigation-link/navigation-link.d.ts

@@ -0,0 +1,43 @@
+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";
+import Link from "next/link";
+//#region src/particles/navigation-link/navigation-link.d.ts
+export declare const NavigationLinkContent: {
+  readonly id: "navigation-link";
+  readonly title: "Navigation Link";
+  readonly description: "Link label, destination, and whether it opens in a new tab.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["text"];
+    readonly properties: {
+      readonly text: {
+        readonly type: "string";
+        readonly minLength: 1;
+        readonly title: "Label";
+      };
+      readonly href: {
+        readonly type: "string";
+        readonly title: "Destination";
+        readonly format: "uri-reference";
+        readonly pattern: "^$|^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$";
+      };
+      readonly target: {
+        readonly type: "string";
+        readonly enum: readonly ["_self", "_blank"];
+        readonly title: "Target";
+      };
+    };
+  };
+};
+export type NavigationLinkProps = ComponentPropsWithRef<typeof Link> & {
+  /** Merchant-authored link, sliced from the page/layout content entry; wins over the props field by
+   *  field when present. Absent in a non-CMS store — the props are the fallback. */
+  $content?: ContentValue<typeof NavigationLinkContent>;
+};
+export declare const NavigationLinkDefinition: ComponentDefinition<NavigationLinkProps>;
+export declare function NavigationLink({ href, className, children, target, rel, $content, ...props }: NavigationLinkProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=navigation-link.d.ts.map

package/dist/particles/navigation-link/navigation-link.js

@@ -0,0 +1,82 @@
+"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 } from "../../utils/safe-href.js";
+import { jsx } from "react/jsx-runtime";
+import Link from "next/link";
+//#region src/particles/navigation-link/navigation-link.tsx
+const NavigationLinkContent = defineContentType({
+	id: "navigation-link",
+	title: "Navigation Link",
+	description: "Link label, destination, and whether it opens in a new tab.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		required: ["text"],
+		properties: {
+			text: {
+				type: "string",
+				minLength: 1,
+				title: "Label"
+			},
+			href: {
+				type: "string",
+				title: "Destination",
+				format: "uri-reference",
+				pattern: "^$|^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$"
+			},
+			target: {
+				type: "string",
+				enum: ["_self", "_blank"],
+				title: "Target"
+			}
+		}
+	}
+});
+const NavigationLinkDefinition = defineComponent({
+	name: "NavigationLink",
+	importPath: "@vtex/faststore/components",
+	component: NavigationLink,
+	content: NavigationLinkContent,
+	editor: {
+		label: "Navigation Link",
+		category: "navigation"
+	},
+	schema: {
+		href: {
+			type: "string",
+			label: "URL"
+		},
+		target: {
+			type: ["_self", "_blank"],
+			default: "_self",
+			label: "Target"
+		}
+	},
+	guideline: "Client-side navigation link built on Next.js Link. Use for all internal navigation to avoid full-page reloads. Set target to _blank to open the destination in a new tab; when you do, write an \"(opens in new tab)\" cue into the link text, because the component adds no announcement of its own. A CMS entry overrides the link text, href, and target at runtime; a destination it supplies that is not an http, https, mailto, tel, or site-relative URL is refused and the authored href stands."
+});
+function NavigationLink({ href, className, children, target, rel, $content, ...props }) {
+	const entryDestination = $content?.href?.trim() ? resolveSafeHref($content.href) : null;
+	if (entryDestination && !entryDestination.safe) console.warn("[NavigationLink] link destination rejected", { reason: entryDestination.reason });
+	const linkHref = entryDestination?.safe ? entryDestination.href : href;
+	const linkTarget = $content?.target ?? target;
+	const linkText = $content?.text?.trim() ? $content.text : children;
+	const opensNewTab = linkTarget?.toLowerCase() === "_blank";
+	const relTokens = rel?.split(/\s+/).filter(Boolean) ?? [];
+	const present = new Set(relTokens.map((token) => token.toLowerCase()));
+	const safeRel = opensNewTab ? [...relTokens, ...["noopener", "noreferrer"].filter((token) => !present.has(token))].join(" ") : rel;
+	return /* @__PURE__ */ jsx(Link, {
+		...props,
+		href: linkHref,
+		target: linkTarget,
+		rel: safeRel,
+		className,
+		"data-fs-navigation-link": "",
+		children: linkText
+	});
+}
+//#endregion
+export { NavigationLink, NavigationLinkContent, NavigationLinkDefinition };
+
+//# sourceMappingURL=navigation-link.js.map

package/dist/particles/navigation-link/navigation-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-link.js","names":[],"sources":["../../../src/particles/navigation-link/navigation-link.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport Link from 'next/link';\nimport type { ComponentPropsWithRef } from 'react';\nimport { resolveSafeHref } from '../../utils/safe-href.js';\n\n// Only `text` is required — an entry that just retitles a link should not force the merchant to\n// retype its destination.\nexport const NavigationLinkContent = defineContentType({\n  id: 'navigation-link',\n  title: 'Navigation Link',\n  description: 'Link label, destination, and whether it opens in a new tab.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['text'],\n    properties: {\n      text: { type: 'string', minLength: 1, title: 'Label' },\n      href: {\n        type: 'string',\n        title: 'Destination',\n        // `uri-reference` rather than `uri`, which rejects the root-relative paths most navigation\n        // targets are. Author-time guidance only and lookahead-free, as in the sibling particles;\n        // the empty alternative is this model's own, since clearing the field has to stay saveable.\n        format: 'uri-reference',\n        pattern: '^$|^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$',\n      },\n      target: { type: 'string', enum: ['_self', '_blank'], title: 'Target' },\n    },\n  },\n});\n\nexport type NavigationLinkProps = ComponentPropsWithRef<typeof Link> & {\n  /** Merchant-authored link, sliced from the page/layout content entry; wins over the props field by\n   *  field when present. Absent in a non-CMS store — the props are the fallback. */\n  $content?: ContentValue<typeof NavigationLinkContent>;\n};\n\nexport const NavigationLinkDefinition = defineComponent<NavigationLinkProps>({\n  name: 'NavigationLink',\n  importPath: '@vtex/faststore/components',\n  component: NavigationLink,\n  content: NavigationLinkContent,\n  editor: { label: 'Navigation Link', category: 'navigation' },\n  schema: {\n    href: { type: 'string', label: 'URL' },\n    target: { type: ['_self', '_blank'] as const, default: '_self', label: 'Target' },\n  },\n  guideline:\n    'Client-side navigation link built on Next.js Link. Use for all internal navigation to avoid full-page reloads. Set target to _blank to open the destination in a new tab; when you do, write an \"(opens in new tab)\" cue into the link text, because the component adds no announcement of its own. A CMS entry overrides the link text, href, and target at runtime; a destination it supplies that is not an http, https, mailto, tel, or site-relative URL is refused and the authored href stands.',\n});\n\nexport function NavigationLink({ href, className, children, target, rel, $content, ...props }: NavigationLinkProps) {\n  // Resolve the entry before deriving anything from `target`: a _blank arriving from the CMS needs the\n  // same tab-nabbing defense as an authored one. `href` and `text` fall back on a blank entry field so\n  // a cleared value keeps the authored link rather than emitting an empty destination or label.\n  // Only the entry's destination goes through the allowlist: the prop comes from the store's own\n  // source, while nothing enforces the model's shape on the value the Admin supplies. A refused\n  // destination falls back the same way a cleared one does.\n  const entryDestination = $content?.href?.trim() ? resolveSafeHref($content.href) : null;\n  if (entryDestination && !entryDestination.safe) {\n    // A bounded reason and no authored value, the convention the content runtime's own log follows.\n    console.warn('[NavigationLink] link destination rejected', { reason: entryDestination.reason });\n  }\n  const linkHref = entryDestination?.safe ? entryDestination.href : href;\n  const linkTarget = $content?.target ?? target;\n  const linkText = $content?.text?.trim() ? $content.text : children;\n\n  // Target keywords are ASCII case-insensitive per HTML, so _BLANK opens a new tab just like _blank.\n  const opensNewTab = linkTarget?.toLowerCase() === '_blank';\n  // Append rather than replace: a composing matter may pass its own rel, and the tab-nabbing defense has to survive it.\n  // Link types are case-insensitive too, so a caller-passed NOOPENER already counts as noopener.\n  const relTokens = rel?.split(/\\s+/).filter(Boolean) ?? [];\n  const present = new Set(relTokens.map((token) => token.toLowerCase()));\n  const safeRel = opensNewTab\n    ? [...relTokens, ...['noopener', 'noreferrer'].filter((token) => !present.has(token))].join(' ')\n    : rel;\n\n  return (\n    <Link {...props} href={linkHref} target={linkTarget} rel={safeRel} className={className} data-fs-navigation-link=\"\">\n      {linkText}\n    </Link>\n  );\n}\n"],"mappings":";;;;;;;;AASA,MAAa,wBAAwB,kBAAkB;CACrD,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,UAAU,CAAC,MAAM;EACjB,YAAY;GACV,MAAM;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAQ;GACrD,MAAM;IACJ,MAAM;IACN,OAAO;IAIP,QAAQ;IACR,SAAS;GACX;GACA,QAAQ;IAAE,MAAM;IAAU,MAAM,CAAC,SAAS,QAAQ;IAAG,OAAO;GAAS;EACvE;CACF;AACF,CAAC;AAQD,MAAa,2BAA2B,gBAAqC;CAC3E,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAmB,UAAU;CAAa;CAC3D,QAAQ;EACN,MAAM;GAAE,MAAM;GAAU,OAAO;EAAM;EACrC,QAAQ;GAAE,MAAM,CAAC,SAAS,QAAQ;GAAY,SAAS;GAAS,OAAO;EAAS;CAClF;CACA,WACE;AACJ,CAAC;AAED,SAAgB,eAAe,EAAE,MAAM,WAAW,UAAU,QAAQ,KAAK,UAAU,GAAG,SAA8B;CAOlH,MAAM,mBAAmB,UAAU,MAAM,KAAK,IAAI,gBAAgB,SAAS,IAAI,IAAI;CACnF,IAAI,oBAAoB,CAAC,iBAAiB,MAExC,QAAQ,KAAK,8CAA8C,EAAE,QAAQ,iBAAiB,OAAO,CAAC;CAEhG,MAAM,WAAW,kBAAkB,OAAO,iBAAiB,OAAO;CAClE,MAAM,aAAa,UAAU,UAAU;CACvC,MAAM,WAAW,UAAU,MAAM,KAAK,IAAI,SAAS,OAAO;CAG1D,MAAM,cAAc,YAAY,YAAY,MAAM;CAGlD,MAAM,YAAY,KAAK,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,KAAK,CAAC;CACxD,MAAM,UAAU,IAAI,IAAI,UAAU,KAAK,UAAU,MAAM,YAAY,CAAC,CAAC;CACrE,MAAM,UAAU,cACZ,CAAC,GAAG,WAAW,GAAG,CAAC,YAAY,YAAY,CAAC,CAAC,QAAQ,UAAU,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAC7F;CAEJ,OACE,oBAAC,MAAD;EAAM,GAAI;EAAO,MAAM;EAAU,QAAQ;EAAY,KAAK;EAAoB;EAAW,2BAAwB;EAC9G,UAAA;CACG,CAAA;AAEV"}

package/dist/particles/navigation-link-list/navigation-link-list.d.ts

@@ -0,0 +1,59 @@
+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/particles/navigation-link-list/navigation-link-list.d.ts
+export declare const NavigationLinkListContent: {
+  readonly id: "navigation-link-list";
+  readonly title: "Navigation Links";
+  readonly description: "The ordered list of navigation links, editable without a deployment.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly links: {
+        readonly type: "array";
+        readonly title: "Links";
+        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 target: {
+              readonly type: "string";
+              readonly enum: readonly ["_self", "_blank"];
+              readonly default: "_self";
+              readonly title: "Open in";
+            };
+          };
+        };
+      };
+    };
+  };
+};
+type NavigationLinkListContentValue = ContentValue<typeof NavigationLinkListContent>;
+/** One authored link. Derived from the model so the prop and content channels cannot drift. */
+export type NavigationLinkListLink = NonNullable<NavigationLinkListContentValue['links']>[number];
+export type NavigationLinkListProps = ComponentPropsWithRef<'ul'> & {
+  /** Authored fallback for the link list, used when no CMS entry supplies one. */
+  links?: readonly NavigationLinkListLink[];
+  /** Injected by the compiler, sliced from the page's or layout's composite content entry. */
+  $content?: NavigationLinkListContentValue;
+};
+export declare const NavigationLinkListDefinition: ComponentDefinition<NavigationLinkListProps>;
+export declare function NavigationLinkList({ links, $content, className, ...props }: NavigationLinkListProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=navigation-link-list.d.ts.map

package/dist/particles/navigation-link-list/navigation-link-list.js

@@ -0,0 +1,103 @@
+import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { resolveSafeHref } from "../../utils/safe-href.js";
+import { NavigationLink } from "../navigation-link/navigation-link.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/particles/navigation-link-list/navigation-link-list.tsx
+const NavigationLinkListContent = defineContentType({
+	id: "navigation-link-list",
+	title: "Navigation Links",
+	description: "The ordered list of navigation links, editable without a deployment.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { links: {
+			type: "array",
+			title: "Links",
+			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:.+|/(?:[^/].*)?)$"
+					},
+					target: {
+						type: "string",
+						enum: ["_self", "_blank"],
+						default: "_self",
+						title: "Open in"
+					}
+				}
+			}
+		} }
+	}
+});
+const NavigationLinkListDefinition = defineComponent({
+	name: "NavigationLinkList",
+	importPath: "@vtex/faststore/components",
+	component: NavigationLinkList,
+	content: NavigationLinkListContent,
+	editor: {
+		label: "Navigation Links",
+		category: "navigation"
+	},
+	schema: { links: {
+		type: "array",
+		label: "Links"
+	} },
+	guideline: "The list of navigation links as one CMS-editable collection, so a merchant adds, removes and reorders them without a deployment. Owns its own <ul>, so compose it directly under NavigationMenuRoot for the desktop bar and inside DrawerPopup for the mobile panel — reference the same element id from both and one entry feeds both surfaces. See navigation-link-list.md."
+});
+function resolveLinks(links) {
+	const resolved = [];
+	links.forEach((link, index) => {
+		if (link.label.trim().length === 0) return;
+		const destination = resolveSafeHref(link.href);
+		if (!destination.safe) console.warn("[NavigationLinkList] link destination rejected", {
+			index,
+			reason: destination.reason
+		});
+		resolved.push({
+			label: link.label,
+			href: destination.safe ? destination.href : null,
+			target: link.target
+		});
+	});
+	return resolved;
+}
+function NavigationLinkList({ links, $content, className, ...props }) {
+	const resolved = resolveLinks($content?.links ?? links ?? []);
+	if (resolved.length === 0) return null;
+	return /* @__PURE__ */ jsx("ul", {
+		...props,
+		className,
+		"data-fs-navigation-link-list": "",
+		children: resolved.map((link, index) => /* @__PURE__ */ jsx("li", {
+			"data-fs-navigation-link-list-item": "",
+			children: link.href === null ? /* @__PURE__ */ jsx("span", {
+				"data-fs-text": "",
+				"data-fs-navigation-link-list-text": "",
+				children: link.label
+			}) : /* @__PURE__ */ jsx(NavigationLink, {
+				href: link.href,
+				target: link.target,
+				children: link.label
+			})
+		}, index))
+	});
+}
+//#endregion
+export { NavigationLinkList, NavigationLinkListContent, NavigationLinkListDefinition };
+
+//# sourceMappingURL=navigation-link-list.js.map

package/dist/particles/navigation-link-list/navigation-link-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-link-list.js","names":[],"sources":["../../../src/particles/navigation-link-list/navigation-link-list.tsx"],"sourcesContent":["import { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { resolveSafeHref } from '../../utils/safe-href.js';\nimport { NavigationLink } from '../navigation-link/navigation-link.js';\n\n// ---------------------------------------------------------------------------\n// Content model\n// ---------------------------------------------------------------------------\n\nexport const NavigationLinkListContent = defineContentType({\n  id: 'navigation-link-list',\n  title: 'Navigation Links',\n  description: 'The ordered list of navigation links, editable without a deployment.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    // `links` is not required, for the reason FooterLinkGroup records: a missing element key already\n    // omits the component, so requiring it would only cost the prop fallback its shape validity.\n    properties: {\n      links: {\n        type: 'array',\n        title: 'Links',\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            target: { type: 'string', enum: ['_self', '_blank'], default: '_self', title: 'Open in' },\n          },\n        },\n      },\n    },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype NavigationLinkListContentValue = ContentValue<typeof NavigationLinkListContent>;\n\n/** One authored link. Derived from the model so the prop and content channels cannot drift. */\nexport type NavigationLinkListLink = NonNullable<NavigationLinkListContentValue['links']>[number];\n\nexport type NavigationLinkListProps = ComponentPropsWithRef<'ul'> & {\n  /** Authored fallback for the link list, used when no CMS entry supplies one. */\n  links?: readonly NavigationLinkListLink[];\n  /** Injected by the compiler, sliced from the page's or layout's composite content entry. */\n  $content?: NavigationLinkListContentValue;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const NavigationLinkListDefinition = defineComponent({\n  name: 'NavigationLinkList',\n  importPath: '@vtex/faststore/components',\n  component: NavigationLinkList,\n  content: NavigationLinkListContent,\n  editor: { label: 'Navigation Links', category: 'navigation' },\n  schema: {\n    links: { type: 'array', label: 'Links' },\n  },\n  guideline:\n    'The list of navigation links as one CMS-editable collection, so a merchant adds, removes and reorders them without a deployment. Owns its own <ul>, so compose it directly under NavigationMenuRoot for the desktop bar and inside DrawerPopup for the mobile panel — reference the same element id from both and one entry feeds both surfaces. See navigation-link-list.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/** A resolved link, ready to render. A null `href` is a destination the allowlist refused. */\ntype ResolvedLink = {\n  label: string;\n  href: string | null;\n  target: NavigationLinkListLink['target'];\n};\n\nfunction resolveLinks(links: readonly NavigationLinkListLink[]): ResolvedLink[] {\n  const resolved: ResolvedLink[] = [];\n\n  links.forEach((link, index) => {\n    // `minLength` is enforced by neither the runtime slice nor the preflight, so a blank label\n    // reaches the component. Drop the link: an anchor with no accessible name is a WCAG failure.\n    if (link.label.trim().length === 0) {\n      return;\n    }\n    const destination = resolveSafeHref(link.href);\n    if (!destination.safe) {\n      console.warn('[NavigationLinkList] link destination rejected', { index, reason: destination.reason });\n    }\n    resolved.push({\n      label: link.label,\n      href: destination.safe ? destination.href : null,\n      target: link.target,\n    });\n  });\n\n  return resolved;\n}\n\nexport function NavigationLinkList({ links, $content, className, ...props }: NavigationLinkListProps) {\n  // An entry supplying `links: []` beats an authored prop: a merchant who cleared the list cleared it.\n  // `minItems` guides the Admin form only, so that empty list still reaches this component.\n  const resolved = resolveLinks($content?.links ?? links ?? []);\n\n  if (resolved.length === 0) {\n    return null;\n  }\n\n  return (\n    <ul {...props} className={className} data-fs-navigation-link-list=\"\">\n      {resolved.map((link, index) => (\n        <li key={index} data-fs-navigation-link-list-item=\"\">\n          {link.href === null ? (\n            <span data-fs-text=\"\" data-fs-navigation-link-list-text=\"\">\n              {link.label}\n            </span>\n          ) : (\n            // `target` reaches NavigationLink as a prop, which is where the tab-nabbing defense\n            // lives: it derives rel from the resolved target, so `_blank` carries noopener/noreferrer.\n            <NavigationLink href={link.href} target={link.target}>\n              {link.label}\n            </NavigationLink>\n          )}\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"mappings":";;;;;;;AASA,MAAa,4BAA4B,kBAAkB;CACzD,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EAGtB,YAAY,EACV,OAAO;GACL,MAAM;GACN,OAAO;GACP,UAAU;GACV,OAAO;IACL,MAAM;IACN,sBAAsB;IACtB,UAAU,CAAC,SAAS,MAAM;IAC1B,YAAY;KACV,OAAO;MAAE,MAAM;MAAU,WAAW;MAAG,OAAO;KAAQ;KACtD,MAAM;MACJ,MAAM;MACN,WAAW;MACX,OAAO;MACP,QAAQ;MAER,SAAS;KACX;KACA,QAAQ;MAAE,MAAM;MAAU,MAAM,CAAC,SAAS,QAAQ;MAAG,SAAS;MAAS,OAAO;KAAU;IAC1F;GACF;EACF,EACF;CACF;AACF,CAAC;AAsBD,MAAa,+BAA+B,gBAAgB;CAC1D,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAoB,UAAU;CAAa;CAC5D,QAAQ,EACN,OAAO;EAAE,MAAM;EAAS,OAAO;CAAQ,EACzC;CACA,WACE;AACJ,CAAC;AAaD,SAAS,aAAa,OAA0D;CAC9E,MAAM,WAA2B,CAAC;CAElC,MAAM,SAAS,MAAM,UAAU;EAG7B,IAAI,KAAK,MAAM,KAAK,CAAC,CAAC,WAAW,GAC/B;EAEF,MAAM,cAAc,gBAAgB,KAAK,IAAI;EAC7C,IAAI,CAAC,YAAY,MACf,QAAQ,KAAK,kDAAkD;GAAE;GAAO,QAAQ,YAAY;EAAO,CAAC;EAEtG,SAAS,KAAK;GACZ,OAAO,KAAK;GACZ,MAAM,YAAY,OAAO,YAAY,OAAO;GAC5C,QAAQ,KAAK;EACf,CAAC;CACH,CAAC;CAED,OAAO;AACT;AAEA,SAAgB,mBAAmB,EAAE,OAAO,UAAU,WAAW,GAAG,SAAkC;CAGpG,MAAM,WAAW,aAAa,UAAU,SAAS,SAAS,CAAC,CAAC;CAE5D,IAAI,SAAS,WAAW,GACtB,OAAO;CAGT,OACE,oBAAC,MAAD;EAAI,GAAI;EAAkB;EAAW,gCAA6B;EAC/D,UAAA,SAAS,KAAK,MAAM,UACnB,oBAAC,MAAD;GAAgB,qCAAkC;GAC/C,UAAA,KAAK,SAAS,OACb,oBAAC,QAAD;IAAM,gBAAa;IAAG,qCAAkC;IACrD,UAAA,KAAK;GACF,CAAA,IAIN,oBAAC,gBAAD;IAAgB,MAAM,KAAK;IAAM,QAAQ,KAAK;IAC3C,UAAA,KAAK;GACQ,CAAA;EAEhB,GAZK,KAYL,CACL;CACC,CAAA;AAER"}

package/dist/particles/navigation-menu/navigation-menu.d.ts

@@ -0,0 +1,78 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef, ReactNode } from "react";
+import { NavigationMenu } from "@base-ui/react/navigation-menu";
+//#region src/particles/navigation-menu/navigation-menu.d.ts
+export type NavigationMenuSide = 'top' | 'bottom' | 'left' | 'right';
+export type NavigationMenuAlign = 'start' | 'center' | 'end';
+export type NavigationMenuOrientation = 'horizontal' | 'vertical';
+export type NavigationMenuRootProps = {
+  orientation?: NavigationMenuOrientation;
+  delay?: number;
+  closeDelay?: number;
+  children?: ReactNode;
+};
+export type NavigationMenuListProps = ComponentPropsWithRef<'ul'>;
+export type NavigationMenuItemProps = ComponentPropsWithRef<'li'> & {
+  value?: string;
+};
+export type NavigationMenuTriggerProps = ComponentPropsWithRef<'button'>;
+export type NavigationMenuIconProps = Omit<ComponentPropsWithRef<typeof NavigationMenu.Icon>, 'className'> & {
+  className?: string;
+};
+export type NavigationMenuContentProps = ComponentPropsWithRef<'div'>;
+export type NavigationMenuLinkProps = ComponentPropsWithRef<'a'>;
+export type NavigationMenuPortalProps = {
+  children?: ReactNode;
+};
+export type NavigationMenuPositionerProps = ComponentPropsWithRef<'div'> & {
+  side?: NavigationMenuSide;
+  align?: NavigationMenuAlign;
+  sideOffset?: number;
+};
+export type NavigationMenuPopupProps = Omit<ComponentPropsWithRef<typeof NavigationMenu.Popup>, 'className'> & {
+  className?: string;
+};
+export type NavigationMenuArrowProps = ComponentPropsWithRef<'div'>;
+export type NavigationMenuViewportProps = ComponentPropsWithRef<'div'>;
+export declare const NavigationMenuRootDefinition: ComponentDefinition<NavigationMenuRootProps>;
+export declare const NavigationMenuListDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLUListElement>, HTMLUListElement>>;
+export declare const NavigationMenuItemDefinition: ComponentDefinition<NavigationMenuItemProps>;
+export declare const NavigationMenuTriggerDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>;
+export declare const NavigationMenuIconDefinition: ComponentDefinition<NavigationMenuIconProps>;
+export declare const NavigationMenuContentDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const NavigationMenuLinkDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>>;
+export declare const NavigationMenuPortalDefinition: ComponentDefinition<NavigationMenuPortalProps>;
+export declare const NavigationMenuPositionerDefinition: ComponentDefinition<NavigationMenuPositionerProps>;
+export declare const NavigationMenuPopupDefinition: ComponentDefinition<NavigationMenuPopupProps>;
+export declare const NavigationMenuArrowDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const NavigationMenuViewportDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare function NavigationMenuRoot({ orientation, delay, closeDelay, children }: NavigationMenuRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuList({ className, children, ...props }: NavigationMenuListProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuItem({ value, className, children, ...props }: NavigationMenuItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuTrigger({ className, children, ...props }: NavigationMenuTriggerProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuIcon({ className, children, ...props }: NavigationMenuIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuContent({ className, children, ...props }: NavigationMenuContentProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuLink({ className, children, ...props }: NavigationMenuLinkProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuPortal({ children }: NavigationMenuPortalProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuPositioner({ side, align, sideOffset, className, children, ...props }: NavigationMenuPositionerProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuPopup({ className, children, ...props }: NavigationMenuPopupProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuArrow({ className, children, ...props }: NavigationMenuArrowProps): import("react/jsx-runtime").JSX.Element;
+export declare function NavigationMenuViewport({ className, children, ...props }: NavigationMenuViewportProps): import("react/jsx-runtime").JSX.Element;
+declare const NavigationMenu$1: {
+  Root: typeof NavigationMenuRoot;
+  List: typeof NavigationMenuList;
+  Item: typeof NavigationMenuItem;
+  Trigger: typeof NavigationMenuTrigger;
+  Icon: typeof NavigationMenuIcon;
+  Content: typeof NavigationMenuContent;
+  Link: typeof NavigationMenuLink;
+  Portal: typeof NavigationMenuPortal;
+  Positioner: typeof NavigationMenuPositioner;
+  Popup: typeof NavigationMenuPopup;
+  Arrow: typeof NavigationMenuArrow;
+  Viewport: typeof NavigationMenuViewport;
+};
+//#endregion
+export { NavigationMenu$1 as NavigationMenu };
+//# sourceMappingURL=navigation-menu.d.ts.map