@notionhive/testimonials 0.1.0

package/bin/testimonials.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+const path = require("path");
+const categoryConfig = require("../category.config.json");
+
+function loadCore() {
+  try {
+    return require("@notionhive/core");
+  } catch {
+    return require(path.join(__dirname, "../../core/lib"));
+  }
+}
+
+const { createCategoryCli } = loadCore();
+const run = createCategoryCli(categoryConfig);
+run(path.resolve(__dirname, ".."));

package/category.config.json

@@ -0,0 +1,7 @@
+{
+  "packageName": "@notionhive/testimonials",
+  "binName": "testimonials",
+  "label": "testimonial section",
+  "labelPlural": "testimonial sections",
+  "exampleId": "testimonial-01"
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@notionhive/testimonials",
+  "version": "0.1.0",
+  "description": "Add editable testimonial sections into your Next.js project.",
+  "license": "UNLICENSED",
+  "bin": {
+    "testimonials": "./bin/testimonials.js"
+  },
+  "files": [
+    "bin",
+    "registry",
+    "templates",
+    "category.config.json"
+  ],
+  "scripts": {
+    "prepublishOnly": "node ../../scripts/sync-templates.js"
+  },
+  "dependencies": {
+    "@notionhive/core": "0.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/registry/index.json

@@ -0,0 +1,174 @@
+{
+  "category": "testimonials",
+  "packageName": "@notionhive/testimonials",
+  "items": [
+    {
+      "id": "testimonial-01",
+      "exportName": "Testimonial01",
+      "folderName": "Testimonial01",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial01"
+    },
+    {
+      "id": "testimonial-02",
+      "exportName": "Testimonial02",
+      "folderName": "Testimonial02",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial02"
+    },
+    {
+      "id": "testimonial-03",
+      "exportName": "Testimonial03",
+      "folderName": "Testimonial03",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial03"
+    },
+    {
+      "id": "testimonial-04",
+      "exportName": "Testimonial04",
+      "folderName": "Testimonial04",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial04"
+    },
+    {
+      "id": "testimonial-05",
+      "exportName": "Testimonial05",
+      "folderName": "Testimonial05",
+      "shared": [
+        "atoms/SafeImage"
+      ],
+      "assets": "public/testimonials/testimonial05"
+    },
+    {
+      "id": "testimonial-06",
+      "exportName": "Testimonial06",
+      "folderName": "Testimonial06",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial06"
+    },
+    {
+      "id": "testimonial-07",
+      "exportName": "Testimonial07",
+      "folderName": "Testimonial07",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial07"
+    },
+    {
+      "id": "testimonial-08",
+      "exportName": "Testimonial08",
+      "folderName": "Testimonial08",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial08"
+    },
+    {
+      "id": "testimonial-09",
+      "exportName": "Testimonial09",
+      "folderName": "Testimonial09",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial09"
+    },
+    {
+      "id": "testimonial-10",
+      "exportName": "Testimonial10",
+      "folderName": "Testimonial10",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial10"
+    },
+    {
+      "id": "testimonial-11",
+      "exportName": "Testimonial11",
+      "folderName": "Testimonial11",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial11"
+    },
+    {
+      "id": "testimonial-12",
+      "exportName": "Testimonial12",
+      "folderName": "Testimonial12",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial12"
+    },
+    {
+      "id": "testimonial-13",
+      "exportName": "Testimonial13",
+      "folderName": "Testimonial13",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial13"
+    },
+    {
+      "id": "testimonial-14",
+      "exportName": "Testimonial14",
+      "folderName": "Testimonial14",
+      "shared": [
+        "atoms/SafeImage"
+      ],
+      "assets": "public/testimonials/testimonial14"
+    },
+    {
+      "id": "testimonial-15",
+      "exportName": "Testimonial15",
+      "folderName": "Testimonial15",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial15"
+    },
+    {
+      "id": "testimonial-16",
+      "exportName": "Testimonial16",
+      "folderName": "Testimonial16",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial16"
+    },
+    {
+      "id": "testimonial-17",
+      "exportName": "Testimonial17",
+      "folderName": "Testimonial17",
+      "shared": [
+        "atoms/SafeImage",
+        "hooks/useCarousel"
+      ],
+      "assets": "public/testimonials/testimonial17"
+    }
+  ]
+}

package/registry/testimonial-01.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-01",
+  "exportName": "Testimonial01",
+  "folderName": "Testimonial01",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial01"
+}

package/registry/testimonial-02.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-02",
+  "exportName": "Testimonial02",
+  "folderName": "Testimonial02",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial02"
+}

package/registry/testimonial-03.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-03",
+  "exportName": "Testimonial03",
+  "folderName": "Testimonial03",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial03"
+}

package/registry/testimonial-04.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-04",
+  "exportName": "Testimonial04",
+  "folderName": "Testimonial04",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial04"
+}

package/registry/testimonial-05.json

@@ -0,0 +1,9 @@
+{
+  "id": "testimonial-05",
+  "exportName": "Testimonial05",
+  "folderName": "Testimonial05",
+  "shared": [
+    "atoms/SafeImage"
+  ],
+  "assets": "public/testimonials/testimonial05"
+}

package/registry/testimonial-06.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-06",
+  "exportName": "Testimonial06",
+  "folderName": "Testimonial06",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial06"
+}

package/registry/testimonial-07.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-07",
+  "exportName": "Testimonial07",
+  "folderName": "Testimonial07",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial07"
+}

package/registry/testimonial-08.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-08",
+  "exportName": "Testimonial08",
+  "folderName": "Testimonial08",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial08"
+}

package/registry/testimonial-09.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-09",
+  "exportName": "Testimonial09",
+  "folderName": "Testimonial09",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial09"
+}

package/registry/testimonial-10.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-10",
+  "exportName": "Testimonial10",
+  "folderName": "Testimonial10",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial10"
+}

package/registry/testimonial-11.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-11",
+  "exportName": "Testimonial11",
+  "folderName": "Testimonial11",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial11"
+}

package/registry/testimonial-12.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-12",
+  "exportName": "Testimonial12",
+  "folderName": "Testimonial12",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial12"
+}

package/registry/testimonial-13.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-13",
+  "exportName": "Testimonial13",
+  "folderName": "Testimonial13",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial13"
+}

package/registry/testimonial-14.json

@@ -0,0 +1,9 @@
+{
+  "id": "testimonial-14",
+  "exportName": "Testimonial14",
+  "folderName": "Testimonial14",
+  "shared": [
+    "atoms/SafeImage"
+  ],
+  "assets": "public/testimonials/testimonial14"
+}

package/registry/testimonial-15.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-15",
+  "exportName": "Testimonial15",
+  "folderName": "Testimonial15",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial15"
+}

package/registry/testimonial-16.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-16",
+  "exportName": "Testimonial16",
+  "folderName": "Testimonial16",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial16"
+}

package/registry/testimonial-17.json

@@ -0,0 +1,10 @@
+{
+  "id": "testimonial-17",
+  "exportName": "Testimonial17",
+  "folderName": "Testimonial17",
+  "shared": [
+    "atoms/SafeImage",
+    "hooks/useCarousel"
+  ],
+  "assets": "public/testimonials/testimonial17"
+}

package/templates/components/atoms/SafeImage/SafeImage.jsx

@@ -0,0 +1,101 @@
+import Image from "next/image";
+
+/**
+ * SafeImage — renders local /heroes/ assets reliably.
+ *
+ * Figma exports are often SVG content saved with .png extensions.
+ * Native img avoids next/image SVG restrictions and broken renders in Storybook.
+ *
+ * @param {object} props - Same as next/image (src, alt, fill, className, sizes, priority, width, height).
+ */
+export function SafeImage({
+  src,
+  alt = "",
+  fill,
+  className = "",
+  sizes,
+  priority,
+  width,
+  height,
+  style,
+  ...rest
+}) {
+  if (!src) return null;
+
+  const isLocalAsset =
+    src.startsWith("/heroes/") ||
+    src.startsWith("/menus/") ||
+    src.startsWith("/about/") ||
+    src.startsWith("/services/") ||
+    src.startsWith("/testimonials/") ||
+    src.startsWith("/cta/") ||
+    src.startsWith("/contact/") ||
+    src.startsWith("/footer/");
+  const isSvg = src.endsWith(".svg");
+
+  if (isLocalAsset || isSvg) {
+    if (fill) {
+      return (
+        // eslint-disable-next-line @next/next/no-img-element
+        <img
+          src={src}
+          alt={alt}
+          className={className}
+          style={{
+            ...style,
+            position: "absolute",
+            inset: 0,
+            width: "100%",
+            height: "100%",
+            objectFit: "cover",
+          }}
+          {...rest}
+        />
+      );
+    }
+
+    return (
+      // eslint-disable-next-line @next/next/no-img-element
+      <img
+        src={src}
+        alt={alt}
+        className={className}
+        width={width}
+        height={height}
+        style={style}
+        {...rest}
+      />
+    );
+  }
+
+  if (fill) {
+    return (
+      <Image
+        src={src}
+        alt={alt}
+        fill
+        className={className}
+        sizes={sizes}
+        priority={priority}
+        style={style}
+        {...rest}
+      />
+    );
+  }
+
+  return (
+    <Image
+      src={src}
+      alt={alt}
+      width={width}
+      height={height}
+      className={className}
+      sizes={sizes}
+      priority={priority}
+      style={style}
+      {...rest}
+    />
+  );
+}
+
+export default SafeImage;

package/templates/components/atoms/SafeImage/index.js

@@ -0,0 +1 @@
+export { SafeImage, default } from "./SafeImage";

package/templates/components/hooks/useCarousel.js

@@ -0,0 +1,73 @@
+"use client";
+
+import { useCallback, useEffect, useState } from "react";
+
+/**
+ * useCarousel — shared slide state for hero carousels and sliders.
+ *
+ * @param {object} options
+ * @param {number} [options.count=1] - Total slide count.
+ * @param {number} [options.initialIndex=0] - Starting slide.
+ * @param {boolean} [options.loop=false] - Wrap from last → first.
+ * @param {number} [options.autoPlayMs=0] - Auto-advance interval; 0 = off.
+ * @param {(index: number) => void} [options.onChange] - Called when slide changes.
+ * @returns {{ activeSlide: number, goTo: Function, next: Function, prev: Function, pause: Function, resume: Function, isPaused: boolean }}
+ */
+export function useCarousel({
+  count = 1,
+  initialIndex = 0,
+  loop = false,
+  autoPlayMs = 0,
+  onChange,
+} = {}) {
+  const maxIndex = Math.max(0, count - 1);
+  const [activeSlide, setActiveSlide] = useState(() =>
+    Math.min(Math.max(initialIndex, 0), maxIndex)
+  );
+  const [isPaused, setIsPaused] = useState(false);
+
+  const goTo = useCallback(
+    (index) => {
+      const next = loop
+        ? ((index % count) + count) % count
+        : Math.min(Math.max(index, 0), maxIndex);
+      setActiveSlide(next);
+      onChange?.(next);
+    },
+    [count, loop, maxIndex, onChange]
+  );
+
+  const next = useCallback(() => {
+    if (loop || activeSlide < maxIndex) goTo(activeSlide + 1);
+  }, [activeSlide, goTo, loop, maxIndex]);
+
+  const prev = useCallback(() => {
+    if (loop || activeSlide > 0) goTo(activeSlide - 1);
+  }, [activeSlide, goTo, loop]);
+
+  const pause = useCallback(() => setIsPaused(true), []);
+  const resume = useCallback(() => setIsPaused(false), []);
+
+  useEffect(() => {
+    if (!autoPlayMs || isPaused || count <= 1) return undefined;
+
+    const id = window.setInterval(next, autoPlayMs);
+    return () => window.clearInterval(id);
+  }, [autoPlayMs, count, isPaused, next]);
+
+  useEffect(() => {
+    setActiveSlide((current) => Math.min(Math.max(current, 0), maxIndex));
+  }, [maxIndex]);
+
+  return {
+    activeSlide,
+    goTo,
+    next,
+    prev,
+    pause,
+    resume,
+    isPaused,
+  };
+}
+
+export default useCarousel;