@vtex/faststore 0.0.1

package/dist/particles/incentives/incentives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incentives.js","names":[],"sources":["../../../src/particles/incentives/incentives.tsx"],"sourcesContent":["import { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { resolveSafeHref } from '../../utils/safe-href.js';\nimport { Icon } from '../icon/icon.js';\nimport { Image } from '../image/image.js';\nimport { NavigationLink } from '../navigation-link/navigation-link.js';\n\n// ---------------------------------------------------------------------------\n// Content model\n// ---------------------------------------------------------------------------\n\nexport const IncentivesContent = defineContentType({\n  id: 'incentives',\n  title: 'Incentives',\n  description: 'Store benefit highlights rendered as a strip in the footer.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    // `items` is deliberately optional. A missing element key already omits the component before any\n    // required check runs, so requiring the list would buy nothing and cost the prop fallback: an\n    // entry without it would be shape-invalid and the authored `items` never reached.\n    properties: {\n      items: {\n        type: 'array',\n        title: 'Incentive items',\n        // Author-time guidance only: no read-time gate enforces item bounds, so its one consumer is\n        // the Content Platform Admin's form. An empty list still reaches the component, which\n        // self-hides on it. No ceiling — the swatch has to lay out at any count regardless.\n        minItems: 1,\n        items: {\n          type: 'object',\n          additionalProperties: false,\n          // `title` alone. A nested required property is validated at read time and a violation omits\n          // the whole strip, so every entry here widens the blast radius of one under-filled item.\n          required: ['title'],\n          properties: {\n            // `minLength` on the title alone: it is the required property, so a blank one is the only\n            // blank that decides anything. Both lines render if present and drop if blank, which is\n            // guidance the Admin form has no reason to state differently for one of them.\n            title: { type: 'string', minLength: 1, title: 'Title' },\n            firstLineText: { type: 'string', title: 'First line' },\n            secondLineText: { type: 'string', title: 'Second line' },\n            // Optional, because a benefit strip links nowhere and a shortcut row links everywhere,\n            // and the two are the same shape. Author-time guidance only, deliberately identical to\n            // FooterLinkGroup's so the Admin form cannot reject a destination `resolveSafeHref`\n            // would have accepted; lookahead-free because that regex engine may be an RE2 family.\n            href: {\n              type: 'string',\n              minLength: 1,\n              title: 'Link',\n              format: 'uri-reference',\n              pattern: '^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$',\n            },\n            // Inline rather than a named constant: the catalog scanner reads this file statically and\n            // rejects an identifier it cannot evaluate.\n            icon: {\n              type: 'string',\n              enum: ['truck', 'calendar', 'gift', 'store', 'shield-check'],\n              title: 'Icon',\n            },\n            iconUrl: {\n              type: 'string',\n              format: 'uri',\n              title: 'Custom icon',\n              widget: { 'ui:widget': 'media-gallery' },\n            },\n            alt: { type: 'string', title: 'Custom icon alt text' },\n          },\n        },\n      },\n    },\n  },\n});\n\n/**\n * The benefit glyphs the `icon` enum admits. Exported because a store's `global.json` has to list\n * them under `icons.include` for a CMS-chosen name to resolve at runtime — one import there instead\n * of five retyped strings, which is what keeps the layout task from silently missing one. Reading it\n * off the model rather than declaring it alongside makes the two impossible to drift apart.\n */\nexport const INCENTIVE_ICON_NAMES = IncentivesContent.schema.properties.items.items.properties.icon.enum;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype IncentivesContentValue = ContentValue<typeof IncentivesContent>;\n\n/** One incentive item, identical in the prop and the content channels. */\nexport type IncentiveItem = NonNullable<IncentivesContentValue['items']>[number];\n\ntype IncentiveIconName = NonNullable<IncentiveItem['icon']>;\n\nexport type IncentivesProps = ComponentPropsWithRef<'ul'> & {\n  /** Authored fallback list, rendered when no CMS entry supplies one. */\n  items?: readonly IncentiveItem[];\n  /** Injected by the compiler, sliced from the layout's composite content entry. */\n  $content?: IncentivesContentValue;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const IncentivesDefinition = defineComponent({\n  name: 'Incentives',\n  importPath: '@vtex/faststore/components',\n  component: Incentives,\n  content: IncentivesContent,\n  editor: { label: 'Incentives', category: 'content' },\n  schema: {\n    items: { type: 'array', label: 'Incentive items' },\n  },\n  guideline:\n    \"The store's value propositions as a strip of icon-and-copy items, the whole list CMS-editable: each item carries a title, up to two description lines, either a predefined icon or an uploaded one, and an optional href that turns the whole block into a link. Every predefined icon name must be listed in the store's icons.include. Renders nothing when unconfigured. See incentives.md.\",\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/**\n * The three glyph states an item can reach, kept as a union so \"at most one source\" is a property of\n * the type rather than of how the resolver happens to build it. `alt` belongs to the uploaded member\n * alone, since a sprite glyph has nothing to name.\n */\ntype ResolvedGlyph =\n  | { icon: IncentiveIconName; src?: undefined; alt?: undefined }\n  | { icon?: undefined; src: string; alt?: string }\n  | { icon?: undefined; src?: undefined; alt?: undefined };\n\n/**\n * An item that can render: a non-blank title, its surviving description lines, a glyph state, and a\n * destination the allowlist cleared. The title is the item's identity, so it is the only part whose\n * absence drops the item.\n */\ntype ResolvedIncentive = { title: string; lines: string[]; href: string | null } & ResolvedGlyph;\n\n/**\n * The item's destination, or null for both \"none authored\" and \"the allowlist refused it\". Unlike the\n * link group and the social row, where a link is the whole point, a refusal here costs the anchor\n * alone — an unlinked item is this component's ordinary shape, so the glyph and copy still render.\n */\nfunction resolveHref(raw: string | undefined, index: number): string | null {\n  // Absent and blank are \"no link\", not a rejection, so neither reaches the allowlist or the log.\n  if (!raw?.trim()) return null;\n\n  const destination = resolveSafeHref(raw);\n  if (!destination.safe) {\n    // A bounded reason and no authored value, the convention the content runtime's own log follows.\n    console.warn('[Incentives] link destination rejected', { index, reason: destination.reason });\n    return null;\n  }\n\n  return destination.href;\n}\n\n/**\n * Drops every item with no title to show, and every description line that would render empty.\n * Neither read-time gate enforces `minLength`, so both blanks reach the component. The asymmetry is\n * deliberate: an icon with no label is not an incentive, while a missing line is supplementary.\n */\nfunction resolveIncentives(items: readonly IncentiveItem[]): ResolvedIncentive[] {\n  const resolved: ResolvedIncentive[] = [];\n\n  items.forEach((item, index) => {\n    if (!item.title.trim()) return;\n\n    const lines = [item.firstLineText, item.secondLineText].filter((line): line is string => Boolean(line?.trim()));\n    const href = resolveHref(item.href, index);\n\n    if (item.iconUrl?.trim()) {\n      resolved.push({ title: item.title, lines, href, src: item.iconUrl, alt: item.alt });\n    } else if (item.icon) {\n      resolved.push({ title: item.title, lines, href, icon: item.icon });\n    } else {\n      resolved.push({ title: item.title, lines, href });\n    }\n  });\n\n  return resolved;\n}\n\n/**\n * The item's glyph, or nothing. Presence decides the channel — an upload first, then a predefined\n * sprite name — and an item carrying neither renders as copy alone rather than an empty slot.\n */\nfunction IncentiveGlyph({ item }: { item: ResolvedIncentive }) {\n  if (item.src !== undefined) {\n    return <Image src={item.src} alt={item.alt} data-fs-incentive-icon=\"\" />;\n  }\n\n  if (item.icon !== undefined) {\n    return <Icon name={item.icon} data-fs-incentive-icon=\"\" />;\n  }\n\n  return null;\n}\n\n/**\n * The glyph and copy an item renders in both forms. Kept whole rather than split across the linked\n * and unlinked branches so the anchor wraps the entire block: on a shortcut row the pictogram is\n * half the click target, and a link around the label alone leaves it dead.\n */\nfunction IncentiveBody({ item }: { item: ResolvedIncentive }) {\n  return (\n    <>\n      <IncentiveGlyph item={item} />\n      <p data-fs-text=\"\" data-fs-incentive-title=\"\">\n        {item.title}\n      </p>\n      {item.lines.map((line, lineIndex) => (\n        <p key={lineIndex} data-fs-text=\"\" data-fs-incentive-description=\"\">\n          {line}\n        </p>\n      ))}\n    </>\n  );\n}\n\nexport function Incentives({ items, $content, className, ...props }: IncentivesProps) {\n  const resolved = resolveIncentives($content?.items ?? items ?? []);\n\n  if (resolved.length === 0) return null;\n\n  // `role` precedes the spread so a consumer can still override it.\n  return (\n    // biome-ignore lint/a11y/noRedundantRoles: WebKit drops the implicit list role from a ul whose computed `list-style` is `none` — exactly what this component's swatch sets — so the explicit role is what holds the semantics the list was chosen for.\n    <ul role=\"list\" {...props} className={className} data-fs-incentives=\"\">\n      {resolved.map((item, index) => (\n        <li key={index} data-fs-incentive=\"\">\n          {item.href === null ? (\n            <IncentiveBody item={item} />\n          ) : (\n            // No `target`: these are the store's own shortcuts, not the outbound profiles the social\n            // row forces a new tab for.\n            <NavigationLink href={item.href} data-fs-incentive-link=\"\">\n              <IncentiveBody item={item} />\n            </NavigationLink>\n          )}\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"mappings":"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"}

package/dist/particles/input/input.d.ts

@@ -0,0 +1,9 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/particles/input/input.d.ts
+export type InputProps = ComponentPropsWithRef<'input'>;
+export declare const InputDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>>;
+export declare function Input({ className, ...props }: InputProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=input.d.ts.map

package/dist/particles/input/input.js

@@ -0,0 +1,28 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { jsx } from "react/jsx-runtime";
+import { Input } from "@base-ui/react/input";
+//#region src/particles/input/input.tsx
+const InputDefinition = defineComponent({
+	name: "Input",
+	importPath: "@vtex/faststore/components",
+	component: Input$1,
+	editor: {
+		label: "Input",
+		category: "action"
+	},
+	schema: {},
+	guideline: "Styled native input that automatically integrates with Field.Control for ARIA labeling and validation. Place inside Field.Control for accessible forms. Receives data-invalid, data-focused, data-filled attributes from the parent Field."
+});
+function Input$1({ className, ...props }) {
+	return /* @__PURE__ */ jsx(Input, {
+		...props,
+		className,
+		"data-fs-input": ""
+	});
+}
+//#endregion
+export { Input$1 as Input, InputDefinition };
+
+//# sourceMappingURL=input.js.map

package/dist/particles/input/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","names":["Input","BaseInput"],"sources":["../../../src/particles/input/input.tsx"],"sourcesContent":["'use client';\nimport { Input as BaseInput } from '@base-ui/react/input';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\n\nexport type InputProps = ComponentPropsWithRef<'input'>;\n\nexport const InputDefinition = defineComponent<InputProps>({\n  name: 'Input',\n  importPath: '@vtex/faststore/components',\n  component: Input,\n  editor: { label: 'Input', category: 'action' },\n  schema: {},\n  guideline:\n    'Styled native input that automatically integrates with Field.Control for ARIA labeling and validation. Place inside Field.Control for accessible forms. Receives data-invalid, data-focused, data-filled attributes from the parent Field.',\n});\n\nexport function Input({ className, ...props }: InputProps) {\n  return <BaseInput {...props} className={className} data-fs-input=\"\" />;\n}\n"],"mappings":";;;;;;AAOA,MAAa,kBAAkB,gBAA4B;CACzD,MAAM;CACN,YAAY;CACZ,WAAWA;CACX,QAAQ;EAAE,OAAO;EAAS,UAAU;CAAS;CAC7C,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,SAAgBA,QAAM,EAAE,WAAW,GAAG,SAAqB;CACzD,OAAO,oBAACC,OAAD;EAAW,GAAI;EAAkB;EAAW,iBAAc;CAAI,CAAA;AACvE"}

package/dist/particles/logo/logo.d.ts

@@ -0,0 +1,55 @@
+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/logo/logo.d.ts
+export declare const LogoContent: {
+  readonly id: "logo";
+  readonly title: "Logo";
+  readonly description: "Brand logo asset, alt text, and link destination.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["alt"];
+    readonly properties: {
+      readonly src: {
+        readonly type: "string";
+        readonly minLength: 1;
+        readonly title: "Source URL";
+        readonly widget: {
+          readonly 'ui:widget': "media-gallery";
+        };
+      };
+      readonly alt: {
+        readonly type: "string";
+        readonly minLength: 1;
+        readonly title: "Alt text";
+      };
+      readonly href: {
+        readonly type: "string";
+        readonly minLength: 1;
+        readonly title: "Link destination";
+        readonly format: "uri-reference";
+        readonly pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$";
+      };
+    };
+  };
+};
+/** Props for {@link Logo}. Extends native `<div>` attributes (the styling root). */
+export type LogoProps = Omit<ComponentPropsWithRef<'div'>, 'children'> & {
+  /** Brand logo asset URL. Optional: the render gate, not the type, requires a resolved value. */
+  src?: string;
+  /** Accessible alt text. Optional: the render gate, not the type, requires a resolved value. */
+  alt?: string;
+  /** Navigation destination; defaults to the configured home. Dropped when it fails the safety check. */
+  href?: string;
+  /** Image loading strategy. `eager` suits the above-the-fold header; author `lazy` below it. */
+  loading?: 'lazy' | 'eager';
+  /** Merchant-authored logo, sliced from the page/layout content entry; wins over the props when
+   *  present. Absent in a non-CMS store — the props are the fallback. */
+  $content?: ContentValue<typeof LogoContent>;
+};
+export declare const LogoDefinition: ComponentDefinition<LogoProps>;
+export declare function Logo({ src, alt, href, loading, $content, className, ...props }: LogoProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=logo.d.ts.map

package/dist/particles/logo/logo.js

@@ -0,0 +1,96 @@
+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 { Image } from "../image/image.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/particles/logo/logo.tsx
+const LogoContent = defineContentType({
+	id: "logo",
+	title: "Logo",
+	description: "Brand logo asset, alt text, and link destination.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		required: ["alt"],
+		properties: {
+			src: {
+				type: "string",
+				minLength: 1,
+				title: "Source URL",
+				widget: { "ui:widget": "media-gallery" }
+			},
+			alt: {
+				type: "string",
+				minLength: 1,
+				title: "Alt text"
+			},
+			href: {
+				type: "string",
+				minLength: 1,
+				title: "Link destination",
+				format: "uri-reference",
+				pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$"
+			}
+		}
+	}
+});
+const LogoDefinition = defineComponent({
+	name: "Logo",
+	importPath: "@vtex/faststore/components",
+	component: Logo,
+	content: LogoContent,
+	editor: {
+		label: "Logo",
+		category: "content"
+	},
+	schema: {
+		src: {
+			type: "string",
+			label: "Source URL"
+		},
+		alt: {
+			type: "string",
+			label: "Alt Text"
+		},
+		href: {
+			type: "string",
+			default: "/",
+			label: "Link Destination"
+		},
+		loading: {
+			type: ["lazy", "eager"],
+			default: "eager",
+			label: "Loading"
+		}
+	},
+	guideline: "Brand logo linking to the configured home; a CMS entry overrides its src, alt, and href at runtime. Every prop is optional: an element bound to a CMS entry should author none of them, so an unconfigured store renders no logo instead of a placeholder. Author src and alt only where no entry supplies them, never as a fallback beside one. Size it responsively with a swatch on data-fs-logo, and reach the mark itself through data-fs-logo-image. A destination that is not an http, https, mailto, tel, or site-relative URL is dropped and the image renders unlinked. Loads eagerly for the above-the-fold header; set loading to lazy below the fold. Composes the Image and NavigationLink particles."
+});
+function Logo({ src, alt, href = "/", loading = "eager", $content, className, ...props }) {
+	const logoSrc = $content?.src?.trim() ? $content.src : src;
+	const logoAlt = $content?.alt ?? alt;
+	const logoHref = $content?.href?.trim() ? $content.href : href;
+	if (!logoSrc || !logoAlt?.trim()) return null;
+	const destination = resolveSafeHref(logoHref);
+	if (!destination.safe) console.warn("[Logo] link destination rejected", { reason: destination.reason });
+	const image = /* @__PURE__ */ jsx(Image, {
+		src: logoSrc,
+		alt: logoAlt,
+		loading,
+		"data-fs-logo-image": ""
+	});
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-logo": "",
+		children: destination.safe ? /* @__PURE__ */ jsx(NavigationLink, {
+			href: destination.href,
+			children: image
+		}) : image
+	});
+}
+//#endregion
+export { Logo, LogoContent, LogoDefinition };
+
+//# sourceMappingURL=logo.js.map

package/dist/particles/logo/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","names":[],"sources":["../../../src/particles/logo/logo.tsx"],"sourcesContent":["import { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { resolveSafeHref } from '../../utils/safe-href.js';\nimport { Image } from '../image/image.js';\nimport { NavigationLink } from '../navigation-link/navigation-link.js';\n\n// `src` declares no `format`: a store's logo is usually a root-relative path served from its\n// `public/` folder (`/logo.svg`), which JSON Schema's `uri` format rejects.\nexport const LogoContent = defineContentType({\n  id: 'logo',\n  title: 'Logo',\n  description: 'Brand logo asset, alt text, and link destination.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    // `src` is optional so an entry authoring `alt` alone still validates: a slice missing a\n    // required property is shape-invalid, and the boundary drops the element instead of the field.\n    required: ['alt'],\n    properties: {\n      src: { type: 'string', minLength: 1, title: 'Source URL', widget: { 'ui:widget': 'media-gallery' } },\n      alt: { type: 'string', minLength: 1, title: 'Alt text' },\n      href: {\n        type: 'string',\n        minLength: 1,\n        title: 'Link destination',\n        format: 'uri-reference',\n        // The set `resolveSafeHref` admits, so the Admin form cannot reject a destination the render\n        // gate would have kept. Author-time only and lookahead-free, as in the sibling particles.\n        pattern: '^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$',\n      },\n    },\n  },\n});\n\n/** Props for {@link Logo}. Extends native `<div>` attributes (the styling root). */\nexport type LogoProps = Omit<ComponentPropsWithRef<'div'>, 'children'> & {\n  /** Brand logo asset URL. Optional: the render gate, not the type, requires a resolved value. */\n  src?: string;\n  /** Accessible alt text. Optional: the render gate, not the type, requires a resolved value. */\n  alt?: string;\n  /** Navigation destination; defaults to the configured home. Dropped when it fails the safety check. */\n  href?: string;\n  /** Image loading strategy. `eager` suits the above-the-fold header; author `lazy` below it. */\n  loading?: 'lazy' | 'eager';\n  /** Merchant-authored logo, sliced from the page/layout content entry; wins over the props when\n   *  present. Absent in a non-CMS store — the props are the fallback. */\n  $content?: ContentValue<typeof LogoContent>;\n};\n\nexport const LogoDefinition = defineComponent<LogoProps>({\n  name: 'Logo',\n  importPath: '@vtex/faststore/components',\n  component: Logo,\n  content: LogoContent,\n  editor: { label: 'Logo', category: 'content' },\n  schema: {\n    src: { type: 'string', label: 'Source URL' },\n    alt: { type: 'string', label: 'Alt Text' },\n    href: { type: 'string', default: '/', label: 'Link Destination' },\n    loading: { type: ['lazy', 'eager'] as const, default: 'eager', label: 'Loading' },\n  },\n  guideline:\n    'Brand logo linking to the configured home; a CMS entry overrides its src, alt, and href at runtime. Every prop is optional: an element bound to a CMS entry should author none of them, so an unconfigured store renders no logo instead of a placeholder. Author src and alt only where no entry supplies them, never as a fallback beside one. Size it responsively with a swatch on data-fs-logo, and reach the mark itself through data-fs-logo-image. A destination that is not an http, https, mailto, tel, or site-relative URL is dropped and the image renders unlinked. Loads eagerly for the above-the-fold header; set loading to lazy below the fold. Composes the Image and NavigationLink particles.',\n});\n\nexport function Logo({ src, alt, href = '/', loading = 'eager', $content, className, ...props }: LogoProps) {\n  // The optional content fields fall through when blank, so clearing one in the Admin reads as\n  // unauthored. `alt` is required in the model, so a blank value is a violation the gate rejects.\n  const logoSrc = $content?.src?.trim() ? $content.src : src;\n  const logoAlt = $content?.alt ?? alt;\n  const logoHref = $content?.href?.trim() ? $content.href : href;\n\n  if (!logoSrc || !logoAlt?.trim()) {\n    return null;\n  }\n\n  // No read-time validator enforces `format` or `pattern`, so this is the only gate on the CMS value.\n  const destination = resolveSafeHref(logoHref);\n  if (!destination.safe) {\n    // A bounded reason and no authored value, the convention the content runtime's own log follows.\n    console.warn('[Logo] link destination rejected', { reason: destination.reason });\n  }\n\n  const image = <Image src={logoSrc} alt={logoAlt} loading={loading} data-fs-logo-image=\"\" />;\n\n  return (\n    <div {...props} className={className} data-fs-logo=\"\">\n      {destination.safe ? <NavigationLink href={destination.href}>{image}</NavigationLink> : image}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAc,kBAAkB;CAC3C,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EAGtB,UAAU,CAAC,KAAK;EAChB,YAAY;GACV,KAAK;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;IAAc,QAAQ,EAAE,aAAa,gBAAgB;GAAE;GACnG,KAAK;IAAE,MAAM;IAAU,WAAW;IAAG,OAAO;GAAW;GACvD,MAAM;IACJ,MAAM;IACN,WAAW;IACX,OAAO;IACP,QAAQ;IAGR,SAAS;GACX;EACF;CACF;AACF,CAAC;AAiBD,MAAa,iBAAiB,gBAA2B;CACvD,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT,QAAQ;EAAE,OAAO;EAAQ,UAAU;CAAU;CAC7C,QAAQ;EACN,KAAK;GAAE,MAAM;GAAU,OAAO;EAAa;EAC3C,KAAK;GAAE,MAAM;GAAU,OAAO;EAAW;EACzC,MAAM;GAAE,MAAM;GAAU,SAAS;GAAK,OAAO;EAAmB;EAChE,SAAS;GAAE,MAAM,CAAC,QAAQ,OAAO;GAAY,SAAS;GAAS,OAAO;EAAU;CAClF;CACA,WACE;AACJ,CAAC;AAED,SAAgB,KAAK,EAAE,KAAK,KAAK,OAAO,KAAK,UAAU,SAAS,UAAU,WAAW,GAAG,SAAoB;CAG1G,MAAM,UAAU,UAAU,KAAK,KAAK,IAAI,SAAS,MAAM;CACvD,MAAM,UAAU,UAAU,OAAO;CACjC,MAAM,WAAW,UAAU,MAAM,KAAK,IAAI,SAAS,OAAO;CAE1D,IAAI,CAAC,WAAW,CAAC,SAAS,KAAK,GAC7B,OAAO;CAIT,MAAM,cAAc,gBAAgB,QAAQ;CAC5C,IAAI,CAAC,YAAY,MAEf,QAAQ,KAAK,oCAAoC,EAAE,QAAQ,YAAY,OAAO,CAAC;CAGjF,MAAM,QAAQ,oBAAC,OAAD;EAAO,KAAK;EAAS,KAAK;EAAkB;EAAS,sBAAmB;CAAI,CAAA;CAE1F,OACE,oBAAC,OAAD;EAAK,GAAI;EAAkB;EAAW,gBAAa;EAChD,UAAA,YAAY,OAAO,oBAAC,gBAAD;GAAgB,MAAM,YAAY;GAAO,UAAA;EAAsB,CAAA,IAAI;CACpF,CAAA;AAET"}

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

@@ -0,0 +1,103 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef, ReactNode } from "react";
+import { Menu } from "@base-ui/react/menu";
+//#region src/particles/menu/menu.d.ts
+export type MenuSide = 'top' | 'bottom' | 'left' | 'right';
+export type MenuAlign = 'start' | 'center' | 'end';
+export type MenuRootProps = {
+  modal?: boolean;
+  children?: ReactNode;
+};
+export type MenuTriggerProps = ComponentPropsWithRef<'button'>;
+export type MenuPortalProps = {
+  children?: ReactNode;
+};
+export type MenuBackdropProps = ComponentPropsWithRef<'div'>;
+export type MenuPositionerProps = ComponentPropsWithRef<'div'> & {
+  side?: MenuSide;
+  align?: MenuAlign;
+  sideOffset?: number;
+  alignOffset?: number;
+};
+export type MenuPopupProps = ComponentPropsWithRef<'div'>;
+export type MenuArrowProps = ComponentPropsWithRef<'div'>;
+export type MenuItemProps = ComponentPropsWithRef<'div'> & {
+  closeOnClick?: boolean;
+};
+export type MenuLinkItemProps = ComponentPropsWithRef<'a'>;
+export type MenuSeparatorProps = ComponentPropsWithRef<'div'>;
+export type MenuGroupProps = ComponentPropsWithRef<'div'>;
+export type MenuGroupLabelProps = ComponentPropsWithRef<'div'>;
+export type MenuCheckboxItemProps = ComponentPropsWithRef<'div'> & {
+  checked?: boolean;
+  closeOnClick?: boolean;
+};
+export type MenuCheckboxItemIndicatorProps = Omit<ComponentPropsWithRef<typeof Menu.CheckboxItemIndicator>, 'className'> & {
+  className?: string;
+};
+export type MenuRadioGroupProps = ComponentPropsWithRef<'div'> & {
+  value?: string;
+};
+export type MenuRadioItemProps = ComponentPropsWithRef<'div'> & {
+  value: string;
+};
+export type MenuRadioItemIndicatorProps = Omit<ComponentPropsWithRef<typeof Menu.RadioItemIndicator>, 'className'> & {
+  className?: string;
+};
+export declare const MenuRootDefinition: ComponentDefinition<MenuRootProps>;
+export declare const MenuTriggerDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>;
+export declare const MenuPortalDefinition: ComponentDefinition<MenuPortalProps>;
+export declare const MenuBackdropDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const MenuPositionerDefinition: ComponentDefinition<MenuPositionerProps>;
+export declare const MenuPopupDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const MenuArrowDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const MenuItemDefinition: ComponentDefinition<MenuItemProps>;
+export declare const MenuLinkItemDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>>;
+export declare const MenuSeparatorDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const MenuGroupDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const MenuGroupLabelDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const MenuCheckboxItemDefinition: ComponentDefinition<MenuCheckboxItemProps>;
+export declare const MenuCheckboxItemIndicatorDefinition: ComponentDefinition<MenuCheckboxItemIndicatorProps>;
+export declare const MenuRadioGroupDefinition: ComponentDefinition<MenuRadioGroupProps>;
+export declare const MenuRadioItemDefinition: ComponentDefinition<MenuRadioItemProps>;
+export declare const MenuRadioItemIndicatorDefinition: ComponentDefinition<MenuRadioItemIndicatorProps>;
+export declare function MenuRoot({ modal, children }: MenuRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuTrigger({ className, children, ...props }: MenuTriggerProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuPortal({ children }: MenuPortalProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuBackdrop({ className, children, ...props }: MenuBackdropProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuPositioner({ side, align, sideOffset, alignOffset, className, children, ...props }: MenuPositionerProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuPopup({ className, children, ...props }: MenuPopupProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuArrow({ className, children, ...props }: MenuArrowProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuItem({ closeOnClick, className, children, ...props }: MenuItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuLinkItem({ className, children, ...props }: MenuLinkItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuSeparator({ className, children, ...props }: MenuSeparatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuGroup({ className, children, ...props }: MenuGroupProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuGroupLabel({ className, children, ...props }: MenuGroupLabelProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuCheckboxItem({ checked, closeOnClick, className, children, ...props }: MenuCheckboxItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuCheckboxItemIndicator({ className, children, ...props }: MenuCheckboxItemIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuRadioGroup({ value, className, children, ...props }: MenuRadioGroupProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuRadioItem({ value, className, children, ...props }: MenuRadioItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function MenuRadioItemIndicator({ className, children, ...props }: MenuRadioItemIndicatorProps): import("react/jsx-runtime").JSX.Element;
+declare const Menu$1: {
+  Root: typeof MenuRoot;
+  Trigger: typeof MenuTrigger;
+  Portal: typeof MenuPortal;
+  Backdrop: typeof MenuBackdrop;
+  Positioner: typeof MenuPositioner;
+  Popup: typeof MenuPopup;
+  Arrow: typeof MenuArrow;
+  Item: typeof MenuItem;
+  LinkItem: typeof MenuLinkItem;
+  Separator: typeof MenuSeparator;
+  Group: typeof MenuGroup;
+  GroupLabel: typeof MenuGroupLabel;
+  CheckboxItem: typeof MenuCheckboxItem;
+  CheckboxItemIndicator: typeof MenuCheckboxItemIndicator;
+  RadioGroup: typeof MenuRadioGroup;
+  RadioItem: typeof MenuRadioItem;
+  RadioItemIndicator: typeof MenuRadioItemIndicator;
+};
+//#endregion
+export { Menu$1 as Menu };
+//# sourceMappingURL=menu.d.ts.map