@farming-labs/nuxt-theme 0.0.51 → 0.0.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/nuxt-theme",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "description": "Nuxt/Vue UI components for @farming-labs/docs — layout, sidebar, TOC, search, and theme toggle",
   "keywords": [
     "docs",
@@ -60,7 +60,7 @@
   },
   "dependencies": {
     "sugar-high": "^0.9.5",
-    "@farming-labs/docs": "0.0.51"
+    "@farming-labs/docs": "0.0.53"
   },
   "peerDependencies": {
     "nuxt": ">=3.0.0",

package/src/components/DocsContent.vue

@@ -20,6 +20,7 @@ const props = defineProps<{
     editOnGithub?: string;
     lastModified?: string;
     entry?: string;
+    slug?: string;
     locale?: string;
   };
   config?: Record<string, unknown> | null;
@@ -29,6 +30,7 @@ const route = useRoute();
 const openDropdownMenu = ref(false);
 const copyLabel = ref("Copy page");
 const copied = ref(false);
+const selectedFeedback = ref<"positive" | "negative" | null>(null);
 
 const titleSuffix = computed(() =>
   props.config?.metadata?.titleTemplate
@@ -145,6 +147,35 @@ const showPageActions = computed(
 );
 const showActionsAbove = computed(() => pageActionsPosition.value === "above-title" && showPageActions.value);
 const showActionsBelow = computed(() => pageActionsPosition.value === "below-title" && showPageActions.value);
+const feedbackConfig = computed(() => {
+  const defaults = {
+    enabled: false,
+    question: "How is this guide?",
+    positiveLabel: "Good",
+    negativeLabel: "Bad",
+    onFeedback: undefined as ((payload: Record<string, unknown>) => void) | undefined,
+  };
+
+  const feedback = props.config?.feedback as Record<string, unknown> | boolean | null | undefined;
+  if (feedback === undefined || feedback === false) return defaults;
+  if (feedback === true) return { ...defaults, enabled: true };
+  if (typeof feedback !== "object" || feedback === null) return defaults;
+
+  return {
+    enabled: feedback.enabled !== false,
+    question: String((feedback as { question?: string }).question ?? defaults.question),
+    positiveLabel: String(
+      feedback.positiveLabel ?? defaults.positiveLabel,
+    ),
+    negativeLabel: String(
+      feedback.negativeLabel ?? defaults.negativeLabel,
+    ),
+    onFeedback:
+      typeof feedback.onFeedback === "function"
+        ? (feedback.onFeedback as (payload: Record<string, unknown>) => void)
+        : undefined,
+  };
+});
 
 useHead({
   title: () => `${props.data.title}${titleSuffix.value}`,
@@ -201,6 +232,43 @@ function openInProvider(provider: { name: string; urlTemplate: string }) {
   closeDropdown();
 }
 
+function handleFeedback(value: "positive" | "negative") {
+  selectedFeedback.value = value;
+
+  const pathname =
+    typeof window !== "undefined"
+      ? window.location.pathname.replace(/\/$/, "") || "/"
+      : props.data.slug
+        ? `/${entry.value}/${props.data.slug}`
+        : `/${entry.value}`;
+
+  const payload = {
+    value,
+    title: props.data.title,
+    description: props.data.description,
+    url: typeof window !== "undefined" ? window.location.href : pathname,
+    pathname,
+    path: pathname,
+    entry: entry.value,
+    slug: props.data.slug ?? "",
+    locale: props.data.locale,
+  };
+
+  try {
+    feedbackConfig.value.onFeedback?.(payload);
+  } catch {}
+
+  try {
+    if (typeof window !== "undefined" && (window as any).__fdOnFeedback__) {
+      (window as any).__fdOnFeedback__(payload);
+    }
+  } catch {}
+
+  if (typeof window !== "undefined") {
+    window.dispatchEvent(new CustomEvent("fd:feedback", { detail: payload }));
+  }
+}
+
 function handleClickOutside(e: MouseEvent) {
   const target = e.target as Node;
   if (openDropdownMenu.value && !(target as Element).closest?.(".fd-page-action-dropdown")) {
@@ -354,5 +422,49 @@ onUnmounted(() => {
     </template>
 
     <div v-html="htmlWithoutFirstH1" />
+
+    <section v-if="feedbackConfig.enabled" class="fd-feedback" aria-label="Page feedback">
+      <div class="fd-feedback-content">
+        <p class="fd-feedback-question">{{ feedbackConfig.question }}</p>
+        <div class="fd-feedback-actions" role="group" :aria-label="feedbackConfig.question">
+          <button
+            type="button"
+            class="fd-page-action-btn"
+            :aria-pressed="selectedFeedback === 'positive'"
+            :data-selected="selectedFeedback === 'positive' ? 'true' : undefined"
+            @click="handleFeedback('positive')"
+          >
+            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+              <path
+                d="M7 21H5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2h2m0 11V10m0 11h9.28a2 2 0 0 0 1.97-1.66l1.2-7A2 2 0 0 0 17.48 10H13V6.5a2.5 2.5 0 0 0-2.5-2.5L7 10"
+                stroke="currentColor"
+                stroke-width="2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+              />
+            </svg>
+            <span>{{ feedbackConfig.positiveLabel }}</span>
+          </button>
+          <button
+            type="button"
+            class="fd-page-action-btn"
+            :aria-pressed="selectedFeedback === 'negative'"
+            :data-selected="selectedFeedback === 'negative' ? 'true' : undefined"
+            @click="handleFeedback('negative')"
+          >
+            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+              <path
+                d="M17 3h2a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2h-2M17 3v11m0-11H7.72a2 2 0 0 0-1.97 1.66l-1.2 7A2 2 0 0 0 6.52 14H11v3.5a2.5 2.5 0 0 0 2.5 2.5L17 14"
+                stroke="currentColor"
+                stroke-width="2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+              />
+            </svg>
+            <span>{{ feedbackConfig.negativeLabel }}</span>
+          </button>
+        </div>
+      </div>
+    </section>
   </DocsPage>
 </template>

package/styles/docs.css

@@ -649,10 +649,19 @@ samp {
   color: var(--color-fd-foreground);
 }
 
+.fd-page-action-btn[data-selected="true"] {
+  color: var(--color-fd-accent-foreground);
+  background: var(--color-fd-accent);
+}
+
 .fd-page-action-btn svg {
   flex-shrink: 0;
 }
 
+.fd-page-action-btn[data-selected="true"] svg {
+  color: currentColor;
+}
+
 .fd-page-action-dropdown {
   position: relative;
 }
@@ -720,6 +729,35 @@ samp {
   margin-bottom: 1rem;
 }
 
+.fd-feedback {
+  margin-top: 2rem;
+  padding-top: 1.25rem;
+  border-top: 1px solid var(--color-fd-border);
+}
+
+.fd-feedback-content {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.fd-feedback-question {
+  margin: 0;
+  font-size: 0.9375rem;
+  font-weight: 600;
+  line-height: 1.5;
+  color: var(--color-fd-foreground);
+}
+
+.fd-feedback-actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+}
+
 /* ─── Breadcrumb ─────────────────────────────────────────────────────── */
 
 .fd-breadcrumb {