@doneisbetter/gds-core 2.6.3 → 2.6.4

package/dist/{chunk-E3QXLNZO.mjs → chunk-EN3TN22M.mjs}

@@ -1,19 +1,27 @@
 import {
   GdsIcons,
-  GdsVocabulary,
   StateBlock,
-  getSemanticActionLabel
-} from "./chunk-QEPN7PSA.mjs";
+  getSemanticActionLabel,
+  resolveSemanticActionConfig
+} from "./chunk-BAS4ZGKL.mjs";
 
 // src/SemanticButton.tsx
-import { useState, useEffect } from "react";
+import { useEffect, useState } from "react";
 import { Button } from "@mantine/core";
 import { useGdsTranslation } from "@doneisbetter/gds-theme";
 import { IconCheck, IconX } from "@tabler/icons-react";
 import { jsx } from "react/jsx-runtime";
-function SemanticButton({ action, loading, feedbackState, feedbackText, prerenderLabelOnly = true, ...props }) {
+function SemanticButton({
+  action,
+  loading,
+  feedbackState,
+  feedbackText,
+  prerenderLabelOnly = true,
+  vocabularyPacks = [],
+  ...props
+}) {
   const { t } = useGdsTranslation();
-  const config = GdsVocabulary[action];
+  const config = resolveSemanticActionConfig(action, vocabularyPacks);
   const [mounted, setMounted] = useState(!prerenderLabelOnly);
   const [internalFeedback, setInternalFeedback] = useState(null);
   useEffect(() => {
@@ -29,14 +37,14 @@ function SemanticButton({ action, loading, feedbackState, feedbackText, prerende
     }
   }, [feedbackState]);
   let Icon = config.icon;
-  let label = getSemanticActionLabel(action, t);
+  let label = getSemanticActionLabel(action, t, vocabularyPacks);
   let color = props.color;
   if (!mounted) {
     const { leftSection, ...buttonProps } = props;
-    return /* @__PURE__ */ jsx(Button, { loading, color, ...buttonProps, children: getSemanticActionLabel(action) });
+    return /* @__PURE__ */ jsx(Button, { loading, color, ...buttonProps, children: getSemanticActionLabel(action, void 0, vocabularyPacks) });
   }
   if (internalFeedback === "success") {
-    const defaultFeedback = "feedback" in config && config.feedback ? config.feedback : { icon: IconCheck, color: "teal", messageId: "gds.feedback.saved" };
+    const defaultFeedback = config.feedback ?? { icon: IconCheck, color: "teal", messageId: "gds.feedback.saved" };
     Icon = defaultFeedback.icon;
     label = feedbackText || t(defaultFeedback.messageId, "Success");
     color = defaultFeedback.color;
@@ -141,10 +149,118 @@ function GameBoardTile({
   ) });
 }
 
+// src/DiscoveryShell.tsx
+import { AppShell as MantineAppShell, Box, Burger, Group as Group2, ScrollArea } from "@mantine/core";
+import { useDisclosure } from "@mantine/hooks";
+import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
+function DiscoveryShell({
+  header,
+  sidebar,
+  footer,
+  children,
+  mobileNavigationLabel = "Toggle navigation",
+  defaultSidebarOpen = false,
+  stickySidebar = true,
+  sidebarWidth = 280,
+  headerHeight = 60,
+  shellPadding = "md",
+  collapseBreakpoint = "sm"
+}) {
+  const [opened, { toggle, close }] = useDisclosure(defaultSidebarOpen);
+  return /* @__PURE__ */ jsxs2(
+    MantineAppShell,
+    {
+      header: { height: headerHeight },
+      footer: footer ? { height: 68 } : void 0,
+      navbar: {
+        width: sidebarWidth,
+        breakpoint: collapseBreakpoint,
+        collapsed: { mobile: !opened }
+      },
+      padding: shellPadding,
+      children: [
+        /* @__PURE__ */ jsx5(MantineAppShell.Header, { children: /* @__PURE__ */ jsxs2(Group2, { h: "100%", px: "md", gap: "sm", wrap: "nowrap", children: [
+          /* @__PURE__ */ jsx5(
+            Burger,
+            {
+              opened,
+              onClick: toggle,
+              hiddenFrom: collapseBreakpoint,
+              size: "sm",
+              "aria-label": mobileNavigationLabel
+            }
+          ),
+          /* @__PURE__ */ jsx5(Box, { style: { flex: 1, minWidth: 0 }, children: header })
+        ] }) }),
+        /* @__PURE__ */ jsx5(MantineAppShell.Navbar, { p: "md", "data-sticky-sidebar": stickySidebar || void 0, children: /* @__PURE__ */ jsx5(ScrollArea, { h: "100%", type: "auto", children: /* @__PURE__ */ jsx5(
+          Box,
+          {
+            h: "100%",
+            style: stickySidebar ? {
+              display: "flex",
+              flexDirection: "column"
+            } : void 0,
+            children: sidebar
+          }
+        ) }) }),
+        footer ? /* @__PURE__ */ jsx5(MantineAppShell.Footer, { children: /* @__PURE__ */ jsx5(Group2, { h: "100%", px: "md", justify: "space-around", wrap: "nowrap", children: footer }) }) : null,
+        /* @__PURE__ */ jsx5(MantineAppShell.Main, { onClick: () => close(), children })
+      ]
+    }
+  );
+}
+
+// src/SidebarNav.tsx
+import { forwardRef } from "react";
+import { Box as Box2, NavLink, Stack, Text as Text3, createPolymorphicComponent } from "@mantine/core";
+import { useGdsTranslation as useGdsTranslation3 } from "@doneisbetter/gds-theme";
+import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+function SidebarNav({ children, ariaLabel = "Primary navigation", gap = "md" }) {
+  return /* @__PURE__ */ jsx6(Stack, { component: "nav", "aria-label": ariaLabel, gap, h: "100%", children });
+}
+function SidebarNavSection({ label, children, pushToBottom = false }) {
+  return /* @__PURE__ */ jsxs3(Stack, { gap: "xs", mt: pushToBottom ? "auto" : void 0, children: [
+    label ? /* @__PURE__ */ jsx6(Text3, { size: "xs", fw: 700, c: "dimmed", children: label }) : null,
+    /* @__PURE__ */ jsx6(Stack, { gap: 4, children })
+  ] });
+}
+var _SidebarNavItem = forwardRef(
+  ({
+    action,
+    label,
+    description,
+    badge,
+    icon,
+    "aria-label": ariaLabel,
+    "aria-current": ariaCurrent,
+    vocabularyPacks = [],
+    ...props
+  }, ref) => {
+    const { t } = useGdsTranslation3();
+    const config = action ? resolveSemanticActionConfig(action, vocabularyPacks) : null;
+    const Icon = config?.icon;
+    const resolvedLabel = label ?? (action ? getSemanticActionLabel(action, t, vocabularyPacks) : void 0);
+    return /* @__PURE__ */ jsx6(
+      NavLink,
+      {
+        ref,
+        label: resolvedLabel,
+        description,
+        leftSection: icon ?? (Icon ? /* @__PURE__ */ jsx6(Icon, { size: "1rem", stroke: 1.5 }) : void 0),
+        rightSection: badge ? /* @__PURE__ */ jsx6(Box2, { children: badge }) : props.rightSection,
+        "aria-label": ariaLabel ?? (typeof resolvedLabel === "string" ? resolvedLabel : void 0),
+        "aria-current": props.active ? "page" : ariaCurrent,
+        ...props
+      }
+    );
+  }
+);
+var SidebarNavItem = createPolymorphicComponent(_SidebarNavItem);
+
 // src/DocsCodeBlock.tsx
 import { useState as useState2 } from "react";
-import { ActionIcon as ActionIcon2, Code, Group as Group2, Paper as Paper2, Stack, Text as Text3 } from "@mantine/core";
-import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
+import { ActionIcon as ActionIcon2, Code, Group as Group3, Paper as Paper2, Stack as Stack2, Text as Text4 } from "@mantine/core";
+import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
 function DocsCodeBlock({ code, language, title, withCopy = true }) {
   const [copied, setCopied] = useState2(false);
   const handleCopy = async () => {
@@ -155,13 +271,13 @@ function DocsCodeBlock({ code, language, title, withCopy = true }) {
     setCopied(true);
     window.setTimeout(() => setCopied(false), 1200);
   };
-  return /* @__PURE__ */ jsx5(Paper2, { withBorder: true, radius: "lg", p: "md", children: /* @__PURE__ */ jsxs2(Stack, { gap: "sm", children: [
-    title || withCopy ? /* @__PURE__ */ jsxs2(Group2, { justify: "space-between", align: "center", children: [
-      /* @__PURE__ */ jsxs2(Stack, { gap: 0, children: [
-        title ? /* @__PURE__ */ jsx5(Text3, { fw: 600, children: title }) : null,
-        language ? /* @__PURE__ */ jsx5(Text3, { size: "xs", c: "dimmed", children: language }) : null
+  return /* @__PURE__ */ jsx7(Paper2, { withBorder: true, radius: "lg", p: "md", children: /* @__PURE__ */ jsxs4(Stack2, { gap: "sm", children: [
+    title || withCopy ? /* @__PURE__ */ jsxs4(Group3, { justify: "space-between", align: "center", children: [
+      /* @__PURE__ */ jsxs4(Stack2, { gap: 0, children: [
+        title ? /* @__PURE__ */ jsx7(Text4, { fw: 600, children: title }) : null,
+        language ? /* @__PURE__ */ jsx7(Text4, { size: "xs", c: "dimmed", children: language }) : null
       ] }),
-      withCopy ? /* @__PURE__ */ jsx5(
+      withCopy ? /* @__PURE__ */ jsx7(
         ActionIcon2,
         {
           variant: "subtle",
@@ -169,18 +285,105 @@ function DocsCodeBlock({ code, language, title, withCopy = true }) {
           onClick: () => {
             void handleCopy();
           },
-          children: /* @__PURE__ */ jsx5(GdsIcons.Copy, { size: "1rem" })
+          children: /* @__PURE__ */ jsx7(GdsIcons.Copy, { size: "1rem" })
         }
       ) : null
     ] }) : null,
-    /* @__PURE__ */ jsx5(Code, { block: true, children: code })
+    /* @__PURE__ */ jsx7(Code, { block: true, children: code })
   ] }) });
 }
 
+// src/ShareButtonGroup.tsx
+import { useState as useState3 } from "react";
+import { ActionIcon as ActionIcon3, Button as Button2, Group as Group4, Stack as Stack3, Text as Text5 } from "@mantine/core";
+import { jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
+var channelLabels = {
+  native: "Share",
+  copy: "Copy link",
+  mail: "Email",
+  message: "Message",
+  x: "Share on X",
+  facebook: "Share on Facebook",
+  linkedin: "Share on LinkedIn",
+  whatsapp: "Share on WhatsApp",
+  telegram: "Share on Telegram"
+};
+function encodeShare(url, title, text) {
+  const safeUrl = encodeURIComponent(url);
+  const safeTitle = encodeURIComponent(title ?? "");
+  const safeText = encodeURIComponent(text ?? title ?? "");
+  return {
+    mail: `mailto:?subject=${safeTitle}&body=${safeText ? `${safeText}%0A%0A` : ""}${safeUrl}`,
+    message: `sms:?&body=${safeText ? `${safeText}%20` : ""}${safeUrl}`,
+    x: `https://x.com/intent/tweet?text=${safeText ? `${safeText}%20` : ""}${safeUrl}`,
+    facebook: `https://www.facebook.com/sharer/sharer.php?u=${safeUrl}`,
+    linkedin: `https://www.linkedin.com/sharing/share-offsite/?url=${safeUrl}`,
+    whatsapp: `https://wa.me/?text=${safeText ? `${safeText}%20` : ""}${safeUrl}`,
+    telegram: `https://t.me/share/url?url=${safeUrl}&text=${safeText}`
+  };
+}
+function ShareAction({
+  channel,
+  compact,
+  href,
+  onClick
+}) {
+  const label = channelLabels[channel];
+  const Icon = channel === "copy" ? GdsIcons.Copy : channel === "mail" ? GdsIcons.Mail : channel === "message" ? GdsIcons.Message : GdsIcons.Refer;
+  if (compact) {
+    return href ? /* @__PURE__ */ jsx8(ActionIcon3, { component: "a", href, target: "_blank", rel: "noreferrer", variant: "subtle", size: "lg", "aria-label": label, children: /* @__PURE__ */ jsx8(Icon, { size: "1rem", stroke: 1.75 }) }) : /* @__PURE__ */ jsx8(ActionIcon3, { variant: "subtle", size: "lg", "aria-label": label, onClick, children: /* @__PURE__ */ jsx8(Icon, { size: "1rem", stroke: 1.75 }) });
+  }
+  return href ? /* @__PURE__ */ jsx8(Button2, { component: "a", href, target: "_blank", rel: "noreferrer", variant: "default", leftSection: /* @__PURE__ */ jsx8(Icon, { size: "1rem", stroke: 1.75 }), children: label }) : /* @__PURE__ */ jsx8(Button2, { variant: "default", leftSection: /* @__PURE__ */ jsx8(Icon, { size: "1rem", stroke: 1.75 }), onClick, children: label });
+}
+function ShareButtonGroup({
+  url,
+  title,
+  text,
+  channels = ["native", "copy", "mail"],
+  compact = false,
+  label = "Share this",
+  description
+}) {
+  const [copied, setCopied] = useState3(false);
+  const [shared, setShared] = useState3(false);
+  const hrefs = encodeShare(url, title, text);
+  async function handleCopy() {
+    await navigator.clipboard?.writeText?.(url);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 1800);
+  }
+  async function handleNativeShare() {
+    if (navigator.share) {
+      await navigator.share({ url, title, text });
+      setShared(true);
+      setTimeout(() => setShared(false), 1800);
+      return;
+    }
+    await handleCopy();
+  }
+  return /* @__PURE__ */ jsxs5(Stack3, { gap: "sm", children: [
+    /* @__PURE__ */ jsxs5(Stack3, { gap: 2, children: [
+      /* @__PURE__ */ jsx8(Text5, { fw: 600, children: label }),
+      description ? /* @__PURE__ */ jsx8(Text5, { size: "sm", c: "dimmed", children: description }) : null
+    ] }),
+    /* @__PURE__ */ jsx8(Group4, { gap: "sm", wrap: "wrap", children: channels.map((channel) => {
+      if (channel === "copy") {
+        return /* @__PURE__ */ jsx8(ShareAction, { channel, compact, onClick: () => void handleCopy() }, channel);
+      }
+      if (channel === "native") {
+        return /* @__PURE__ */ jsx8(ShareAction, { channel, compact, onClick: () => void handleNativeShare() }, channel);
+      }
+      return /* @__PURE__ */ jsx8(ShareAction, { channel, compact, href: hrefs[channel] }, channel);
+    }) }),
+    copied ? /* @__PURE__ */ jsx8(Text5, { size: "sm", c: "teal", children: "Link copied." }) : null,
+    shared ? /* @__PURE__ */ jsx8(Text5, { size: "sm", c: "teal", children: "Share sheet opened." }) : null
+  ] });
+}
+
 // src/UploadDropzone.tsx
-import { useRef, useState as useState3 } from "react";
-import { Box, Button as Button2, Group as Group3, Stack as Stack2, Text as Text4 } from "@mantine/core";
-import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+import { useRef, useState as useState4 } from "react";
+import { Box as Box3, Button as Button3, Group as Group5, Stack as Stack4, Text as Text6 } from "@mantine/core";
+import { jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
 function UploadDropzone({
   title,
   description,
@@ -191,7 +394,7 @@ function UploadDropzone({
   mode = "panel"
 }) {
   const inputRef = useRef(null);
-  const [dragging, setDragging] = useState3(false);
+  const [dragging, setDragging] = useState4(false);
   const UploadIcon = GdsIcons.Upload;
   const forwardFiles = (files) => {
     if (!files?.length || !onFilesSelected) {
@@ -199,8 +402,8 @@ function UploadDropzone({
     }
     onFilesSelected(Array.from(files));
   };
-  return /* @__PURE__ */ jsxs3(
-    Box,
+  return /* @__PURE__ */ jsxs6(
+    Box3,
     {
       onDragOver: (event) => {
         event.preventDefault();
@@ -219,7 +422,7 @@ function UploadDropzone({
         background: dragging ? "var(--mantine-color-violet-light)" : "transparent"
       },
       children: [
-        /* @__PURE__ */ jsx6(
+        /* @__PURE__ */ jsx9(
           "input",
           {
             ref: inputRef,
@@ -230,11 +433,11 @@ function UploadDropzone({
             onChange: (event) => forwardFiles(event.currentTarget.files)
           }
         ),
-        /* @__PURE__ */ jsxs3(Stack2, { align: mode === "inline" ? "flex-start" : "center", ta: mode === "inline" ? "left" : "center", gap: "sm", children: [
-          /* @__PURE__ */ jsx6(UploadIcon, { size: "1.5rem" }),
-          /* @__PURE__ */ jsx6(Text4, { fw: 600, children: title }),
-          description ? /* @__PURE__ */ jsx6(Text4, { size: "sm", c: "dimmed", children: description }) : null,
-          /* @__PURE__ */ jsx6(Group3, { children: /* @__PURE__ */ jsx6(Button2, { variant: "light", onClick: () => inputRef.current?.click(), children: actionLabel }) })
+        /* @__PURE__ */ jsxs6(Stack4, { align: mode === "inline" ? "flex-start" : "center", ta: mode === "inline" ? "left" : "center", gap: "sm", children: [
+          /* @__PURE__ */ jsx9(UploadIcon, { size: "1.5rem" }),
+          /* @__PURE__ */ jsx9(Text6, { fw: 600, children: title }),
+          description ? /* @__PURE__ */ jsx9(Text6, { size: "sm", c: "dimmed", children: description }) : null,
+          /* @__PURE__ */ jsx9(Group5, { children: /* @__PURE__ */ jsx9(Button3, { variant: "light", onClick: () => inputRef.current?.click(), children: actionLabel }) })
         ] })
       ]
     }
@@ -242,9 +445,9 @@ function UploadDropzone({
 }
 
 // src/AccessRecoveryPanel.tsx
-import { Group as Group4 } from "@mantine/core";
-import { useGdsTranslation as useGdsTranslation3 } from "@doneisbetter/gds-theme";
-import { jsx as jsx7 } from "react/jsx-runtime";
+import { Group as Group6 } from "@mantine/core";
+import { useGdsTranslation as useGdsTranslation4 } from "@doneisbetter/gds-theme";
+import { jsx as jsx10 } from "react/jsx-runtime";
 var stateBlockVariantByState = {
   unauthenticated: "permission",
   "expired-session": "info",
@@ -313,7 +516,7 @@ function ActionGroup({
   if (actions.length === 0) {
     return null;
   }
-  return /* @__PURE__ */ jsx7(Group4, { gap: "sm", justify: "center", wrap: "wrap", children: actions.map((actionConfig, index) => /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsx10(Group6, { gap: "sm", justify: "center", wrap: "wrap", children: actions.map((actionConfig, index) => /* @__PURE__ */ jsx10(
     SemanticButton,
     {
       action: actionConfig.action,
@@ -339,7 +542,7 @@ function AccessRecoveryPanel({
   supportAction,
   compact = false
 }) {
-  const { t } = useGdsTranslation3();
+  const { t } = useGdsTranslation4();
   const defaultCopy = defaultCopyByState[state];
   const defaults = defaultActionsForState(state, {
     onRetry,
@@ -347,14 +550,14 @@ function AccessRecoveryPanel({
     onBack,
     supportAction
   });
-  return /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsx10(
     StateBlock,
     {
       variant: stateBlockVariantByState[state],
       compact,
       title: title ?? t(`gds.accessRecovery.${state}.title`, defaultCopy.title),
       description: description ?? t(`gds.accessRecovery.${state}.description`, defaultCopy.description),
-      action: /* @__PURE__ */ jsx7(
+      action: /* @__PURE__ */ jsx10(
         ActionGroup,
         {
           primaryAction: primaryAction ?? defaults.primary,
@@ -371,7 +574,12 @@ export {
   ConfirmDialog,
   ThemeToggle,
   GameBoardTile,
+  DiscoveryShell,
+  SidebarNav,
+  SidebarNavSection,
+  SidebarNavItem,
   DocsCodeBlock,
+  ShareButtonGroup,
   UploadDropzone,
   AccessRecoveryPanel
 };

package/dist/client.d.mts

@@ -1,8 +1,10 @@
-import { SemanticAction } from './server.mjs';
-export { AccentPanel, AccentPanelProps, AccentPanelVariant, AccentTone, AccessSummary, AccessSummaryProps, ArticleShell, ArticleShellProps, AuthShell, AuthShellProps, BreadcrumbItem, BrowseSurface, BrowseSurfaceFilterChip, BrowseSurfaceProps, BrowseSurfaceScopeOption, ChoiceChip, ChoiceChipProps, ConsumerDashboardGrid, ConsumerDashboardGridProps, ConsumerSection, ConsumerSectionProps, CtaButtonGroup, CtaButtonGroupProps, DataToolbar, DataToolbarFilterChip, DataToolbarProps, DocsPageShell, DocsPageShellProps, EditorialCard, EditorialCardProps, EditorialHero, EditorialHeroAction, EditorialHeroMetaItem, EditorialHeroProps, EmptyState, EmptyStateProps, FeatureBand, FeatureBandItem, FeatureBandProps, FilterDrawer, FilterDrawerMode, FilterDrawerProps, FormField, FormFieldProps, GdsIcons, GdsLocale, GdsVocabulary, MediaCard, MediaCardAction, MediaCardProps, MediaField, MediaFieldProps, MetricCard, MetricCardProps, PageHeader, PageHeaderEyebrowVariant, PageHeaderProps, PlaceholderPanel, PlaceholderPanelProps, ProductCard, ProductCardAction, ProductCardMetaItem, ProductCardProps, ProgressCard, ProgressCardProps, PublicBrandFooter, PublicBrandFooterClassNames, PublicBrandFooterLayoutVariant, PublicBrandFooterProps, PublicNav, PublicNavItem, PublicNavProps, PublicProductCard, PublicProductCardHelperKind, PublicProductCardMetaItem, PublicProductCardProps, PublicProductCardState, PublicShell, PublicShellClassNames, PublicShellHeaderVariant, PublicShellMobileNavigationMode, PublicShellProps, PublicSiteFooter, PublicSiteFooterProps, SectionPanel, SectionPanelProps, SectionPanelTone, SimpleDataTable, SimpleDataTableProps, SimpleTableColumn, StateBlock, StateBlockProps, StateBlockVariant, StatsSection, StatsSectionProps, StatusBadge, StatusBadgeProps, StatusVariant, ar, de, en, es, fr, gdsLocales, getGdsMessages, getSemanticActionConfig, getSemanticActionLabel, he, hu, it, resolveAccentPanelStyles, ru } from './server.mjs';
+import { b2 as SemanticAction, b4 as SemanticActionId, a7 as GdsVocabularyPack } from './server-BqFksoV3.mjs';
+export { A as AccentPanel, a as AccentPanelProps, b as AccentPanelVariant, c as AccentTone, d as AccessSummary, e as AccessSummaryProps, f as ActionBar, g as ActionBarAction, h as ActionBarIconAction, i as ActionBarProps, j as ArticleShell, k as ArticleShellProps, l as AuthShell, m as AuthShellProps, B as BreadcrumbItem, n as BrowseSurface, o as BrowseSurfaceFilterChip, p as BrowseSurfaceProps, q as BrowseSurfaceScopeOption, C as ChoiceChip, r as ChoiceChipProps, s as ConsumerDashboardGrid, t as ConsumerDashboardGridProps, u as ConsumerSection, v as ConsumerSectionProps, w as CtaButtonGroup, x as CtaButtonGroupProps, D as DataToolbar, y as DataToolbarFilterChip, z as DataToolbarProps, E as DetailProfileShell, F as DetailProfileShellProps, G as DocsPageShell, H as DocsPageShellProps, I as EditorialCard, J as EditorialCardProps, K as EditorialHero, L as EditorialHeroAction, M as EditorialHeroMetaItem, N as EditorialHeroProps, O as EmptyState, P as EmptyStateProps, Q as FeatureBand, R as FeatureBandItem, S as FeatureBandProps, T as FilterDrawer, U as FilterDrawerMode, V as FilterDrawerProps, W as FoodCardAvailabilityState, X as FoodCardMarker, Y as FoodCardMediaRatio, Z as FoodCardMetadata, _ as FoodMenuCategory, $ as FoodMenuItem, a0 as FoodMenuSection, a1 as FoodMenuSectionProps, a2 as FormField, a3 as FormFieldProps, a4 as GdsIcons, a5 as GdsLocale, a6 as GdsVocabulary, a8 as ListingCard, a9 as ListingCardAffordance, aa as ListingCardMediaRatio, ab as ListingCardProps, ac as ListingMetadataRow, ad as MapPanel, ae as MapPanelProps, af as MediaCard, ag as MediaCardAction, ah as MediaCardProps, ai as MediaField, aj as MediaFieldProps, ak as MetricCard, al as MetricCardProps, am as PageHeader, an as PageHeaderEyebrowVariant, ao as PageHeaderProps, ap as PlaceholderPanel, aq as PlaceholderPanelProps, ar as PlaybackSurface, as as PlaybackSurfaceProps, at as PlaybackSurfaceState, au as ProductCard, av as ProductCardAction, aw as ProductCardMetaItem, ax as ProductCardProps, ay as ProgressCard, az as ProgressCardProps, aA as PublicBrandFooter, aB as PublicBrandFooterClassNames, aC as PublicBrandFooterLayoutVariant, aD as PublicBrandFooterProps, aE as PublicFlowAction, aF as PublicFlowActionPriority, aG as PublicFlowShell, aH as PublicFlowShellProps, aI as PublicFlowStage, aJ as PublicFlowStageStatus, aK as PublicFoodCard, aL as PublicFoodCardProps, aM as PublicNav, aN as PublicNavItem, aO as PublicNavProps, aP as PublicProductCard, aQ as PublicProductCardHelperKind, aR as PublicProductCardMetaItem, aS as PublicProductCardProps, aT as PublicProductCardState, aU as PublicShell, aV as PublicShellClassNames, aW as PublicShellHeaderVariant, aX as PublicShellMobileNavigationMode, aY as PublicShellProps, aZ as PublicSiteFooter, a_ as PublicSiteFooterProps, a$ as SectionPanel, b0 as SectionPanelProps, b1 as SectionPanelTone, b3 as SemanticActionDefinition, b5 as SimpleDataTable, b6 as SimpleDataTableProps, b7 as SimpleTableColumn, b8 as SocialAuthButtons, b9 as SocialAuthButtonsProps, ba as SocialAuthProviderId, bb as SocialAuthProviderOption, bc as StateBlock, bd as StateBlockProps, be as StateBlockVariant, bf as StatsSection, bg as StatsSectionProps, bh as StatusBadge, bi as StatusBadgeProps, bj as StatusVariant, bk as VocabularyResolver, bl as ar, bm as createGdsVocabularyPack, bn as de, bo as en, bp as es, bq as fr, br as gdsLocales, bs as getGdsMessages, bt as getSemanticActionConfig, bu as getSemanticActionLabel, bv as he, bw as hu, bx as it, by as mergeGdsVocabularyPacks, bz as resolveAccentPanelStyles, bA as resolveSemanticActionConfig, bB as ru } from './server-BqFksoV3.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import react__default, { ReactNode } from 'react';
-import { ButtonProps, MantineColor } from '@mantine/core';
+import * as _mantine_core from '@mantine/core';
+import { ButtonProps, MantineColor, MantineSpacing, MantineBreakpoint, NavLinkProps } from '@mantine/core';
 import '@tabler/icons-react';
 
 interface ConfirmDialogProps {
@@ -31,17 +33,14 @@ interface ThemeToggleProps {
 declare function ThemeToggle({ size }: ThemeToggleProps): react_jsx_runtime.JSX.Element;
 
 interface SemanticButtonProps extends ButtonProps, Omit<react__default.ComponentPropsWithoutRef<'button'>, keyof ButtonProps | 'leftSection' | 'children'> {
-    action: SemanticAction;
+    action: SemanticActionId;
     loading?: boolean;
     feedbackState?: 'success' | 'error' | null;
     feedbackText?: string;
     prerenderLabelOnly?: boolean;
+    vocabularyPacks?: GdsVocabularyPack[];
 }
-/**
- * SemanticButton strictly enforces ubiquitous language and standardized iconography.
- * Developers cannot pass arbitrary text or icons; they must use a semantic action key.
- */
-declare function SemanticButton({ action, loading, feedbackState, feedbackText, prerenderLabelOnly, ...props }: SemanticButtonProps): react_jsx_runtime.JSX.Element;
+declare function SemanticButton({ action, loading, feedbackState, feedbackText, prerenderLabelOnly, vocabularyPacks, ...props }: SemanticButtonProps): react_jsx_runtime.JSX.Element;
 
 interface GameBoardTileProps {
     face: ReactNode;
@@ -58,6 +57,57 @@ interface GameBoardTileProps {
  */
 declare function GameBoardTile({ face, revealed, matched, disabled, onPress, highlightColor, }: GameBoardTileProps): react_jsx_runtime.JSX.Element;
 
+interface DiscoveryShellProps {
+    header?: ReactNode;
+    sidebar: ReactNode;
+    footer?: ReactNode;
+    children: ReactNode;
+    mobileNavigationLabel?: string;
+    defaultSidebarOpen?: boolean;
+    stickySidebar?: boolean;
+    sidebarWidth?: number | string;
+    headerHeight?: number | string;
+    shellPadding?: MantineSpacing | number;
+    collapseBreakpoint?: MantineBreakpoint;
+}
+/**
+ * DiscoveryShell is the canonical sidebar-first application shell for GDS.
+ * It owns the responsive header, sidebar, and main-content layout contract.
+ */
+declare function DiscoveryShell({ header, sidebar, footer, children, mobileNavigationLabel, defaultSidebarOpen, stickySidebar, sidebarWidth, headerHeight, shellPadding, collapseBreakpoint, }: DiscoveryShellProps): react_jsx_runtime.JSX.Element;
+
+interface SidebarNavProps {
+    children: ReactNode;
+    ariaLabel?: string;
+    gap?: string | number;
+}
+interface SidebarNavSectionProps {
+    label?: ReactNode;
+    children: ReactNode;
+    pushToBottom?: boolean;
+}
+interface SidebarNavItemProps extends Omit<NavLinkProps, 'label' | 'leftSection' | 'description'> {
+    action?: SemanticActionId;
+    label?: ReactNode;
+    description?: ReactNode;
+    badge?: ReactNode;
+    icon?: ReactNode;
+    'aria-label'?: string;
+    'aria-current'?: 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false';
+    vocabularyPacks?: GdsVocabularyPack[];
+}
+declare function SidebarNav({ children, ariaLabel, gap }: SidebarNavProps): react_jsx_runtime.JSX.Element;
+declare function SidebarNavSection({ label, children, pushToBottom }: SidebarNavSectionProps): react_jsx_runtime.JSX.Element;
+declare const SidebarNavItem: (<C = "a">(props: _mantine_core.PolymorphicComponentProps<C, SidebarNavItemProps>) => React.ReactElement) & Omit<react.FunctionComponent<(SidebarNavItemProps & {
+    component?: any;
+} & Omit<Omit<any, "ref">, "component" | keyof SidebarNavItemProps> & {
+    ref?: any;
+    renderRoot?: (props: any) => any;
+}) | (SidebarNavItemProps & {
+    component: React.ElementType;
+    renderRoot?: (props: Record<string, any>) => any;
+})>, never> & Record<string, never>;
+
 interface DocsCodeBlockProps {
     code: string;
     language?: string;
@@ -66,6 +116,18 @@ interface DocsCodeBlockProps {
 }
 declare function DocsCodeBlock({ code, language, title, withCopy }: DocsCodeBlockProps): react_jsx_runtime.JSX.Element;
 
+type ShareChannel = 'native' | 'copy' | 'mail' | 'message' | 'x' | 'facebook' | 'linkedin' | 'whatsapp' | 'telegram';
+interface ShareButtonGroupProps {
+    url: string;
+    title?: string;
+    text?: string;
+    channels?: ShareChannel[];
+    compact?: boolean;
+    label?: ReactNode;
+    description?: ReactNode;
+}
+declare function ShareButtonGroup({ url, title, text, channels, compact, label, description, }: ShareButtonGroupProps): react_jsx_runtime.JSX.Element;
+
 interface UploadDropzoneProps {
     title: string;
     description?: string;
@@ -101,4 +163,4 @@ interface AccessRecoveryPanelProps {
 }
 declare function AccessRecoveryPanel({ state, title, description, primaryAction, secondaryAction, tertiaryAction, onRetry, onSignIn, onBack, supportAction, compact, }: AccessRecoveryPanelProps): react_jsx_runtime.JSX.Element;
 
-export { type AccessRecoveryAction, AccessRecoveryPanel, type AccessRecoveryPanelProps, type AccessRecoveryState, ConfirmDialog, type ConfirmDialogProps, DocsCodeBlock, type DocsCodeBlockProps, GameBoardTile, type GameBoardTileProps, SemanticAction, SemanticButton, type SemanticButtonProps, ThemeToggle, type ThemeToggleProps, UploadDropzone, type UploadDropzoneProps };
+export { type AccessRecoveryAction, AccessRecoveryPanel, type AccessRecoveryPanelProps, type AccessRecoveryState, ConfirmDialog, type ConfirmDialogProps, DiscoveryShell, type DiscoveryShellProps, DocsCodeBlock, type DocsCodeBlockProps, GameBoardTile, type GameBoardTileProps, GdsVocabularyPack, SemanticAction, SemanticActionId, SemanticButton, type SemanticButtonProps, ShareButtonGroup, type ShareButtonGroupProps, type ShareChannel, SidebarNav, SidebarNavItem, type SidebarNavItemProps, type SidebarNavProps, SidebarNavSection, type SidebarNavSectionProps, ThemeToggle, type ThemeToggleProps, UploadDropzone, type UploadDropzoneProps };