@docubook/mdx 1.0.0

package/dist/index.js

@@ -0,0 +1,428 @@
+// src/core/components/Button.tsx
+import * as Icons from "lucide-react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function Button({
+  icon,
+  text,
+  href,
+  target,
+  size = "md",
+  variation = "primary",
+  LinkComponent
+}) {
+  const baseStyles = "inline-flex items-center justify-center rounded font-medium focus:outline-none transition no-underline";
+  const sizeStyles = {
+    sm: "px-3 py-1 my-6 text-sm",
+    md: "px-4 py-2 my-6 text-base",
+    lg: "px-5 py-3 my-6 text-lg"
+  };
+  const variationStyles = {
+    primary: "bg-primary text-white hover:bg-primary/90",
+    accent: "bg-accent text-white hover:bg-accent/90",
+    outline: "border border-accent text-accent hover:bg-accent/10"
+  };
+  const Icon = icon ? Icons[icon] : null;
+  const className = `${baseStyles} ${sizeStyles[size]} ${variationStyles[variation]}`;
+  const inner = /* @__PURE__ */ jsxs(Fragment, { children: [
+    text && /* @__PURE__ */ jsx("span", { children: text }),
+    Icon && /* @__PURE__ */ jsx(Icon, { className: "mr-2 h-5 w-5" })
+  ] });
+  if (LinkComponent) {
+    return /* @__PURE__ */ jsx(
+      LinkComponent,
+      {
+        href,
+        target,
+        rel: target === "_blank" ? "noopener noreferrer" : void 0,
+        className,
+        children: inner
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    "a",
+    {
+      href,
+      target,
+      rel: target === "_blank" ? "noopener noreferrer" : void 0,
+      className,
+      children: inner
+    }
+  );
+}
+
+// src/core/components/Card.tsx
+import * as Icons2 from "lucide-react";
+import clsx from "clsx";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function Card({
+  title,
+  icon,
+  href,
+  horizontal,
+  children,
+  className,
+  LinkComponent
+}) {
+  const Icon = icon ? Icons2[icon] : null;
+  const content = /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      className: clsx(
+        "border rounded-lg shadow-sm p-4 transition-all duration-200",
+        "bg-card text-card-foreground border-border",
+        "hover:bg-accent/5 hover:border-accent/30",
+        "flex gap-2",
+        horizontal ? "flex-row items-start gap-1" : "flex-col space-y-1",
+        className
+      ),
+      children: [
+        Icon && /* @__PURE__ */ jsx2(Icon, { className: clsx("w-5 h-5 text-primary shrink-0", horizontal && "mt-0.5") }),
+        /* @__PURE__ */ jsxs2("div", { className: "flex-1 min-w-0", children: [
+          /* @__PURE__ */ jsx2("div", { className: "text-base font-semibold text-foreground leading-6", children: title }),
+          /* @__PURE__ */ jsx2("div", { className: "text-sm text-muted-foreground -mt-3", children })
+        ] })
+      ]
+    }
+  );
+  if (!href) return content;
+  if (LinkComponent) {
+    return /* @__PURE__ */ jsx2(LinkComponent, { href, className: "no-underline block", children: content });
+  }
+  return /* @__PURE__ */ jsx2("a", { className: "no-underline block", href, children: content });
+}
+
+// src/core/components/CardGroup.tsx
+import React from "react";
+import clsx2 from "clsx";
+import { jsx as jsx3 } from "react/jsx-runtime";
+function CardGroup({ children, cols = 2, className }) {
+  const cardsArray = React.Children.toArray(children);
+  const gridColsClass = {
+    1: "grid-cols-1",
+    2: "grid-cols-1 sm:grid-cols-2",
+    3: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3",
+    4: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-4"
+  }[cols] || "grid-cols-1 sm:grid-cols-2";
+  return /* @__PURE__ */ jsx3("div", { className: clsx2("grid gap-4 text-foreground", gridColsClass, className), children: cardsArray.map((card, index) => /* @__PURE__ */ jsx3("div", { children: card }, index)) });
+}
+
+// src/core/components/Keyboard.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+var macKeyMap = {
+  command: "\u2318",
+  cmd: "\u2318",
+  option: "\u2325",
+  alt: "\u2325",
+  shift: "\u21E7",
+  ctrl: "\u2303",
+  control: "\u2303",
+  tab: "\u21E5",
+  caps: "\u21EA",
+  enter: "\u23CE",
+  return: "\u23CE",
+  delete: "\u232B",
+  escape: "\u238B",
+  esc: "\u238B",
+  up: "\u2191",
+  down: "\u2193",
+  left: "\u2190",
+  right: "\u2192",
+  space: "\u2423"
+};
+var windowsKeyMap = {
+  command: "Win",
+  cmd: "Win",
+  option: "Alt",
+  alt: "Alt",
+  ctrl: "Ctrl",
+  control: "Ctrl",
+  delete: "Del",
+  escape: "Esc",
+  esc: "Esc",
+  enter: "Enter",
+  return: "Enter",
+  tab: "Tab",
+  caps: "Caps",
+  shift: "Shift",
+  space: "Space",
+  up: "\u2191",
+  down: "\u2193",
+  left: "\u2190",
+  right: "\u2192"
+};
+function Kbd({
+  show: keyProp,
+  type = "window",
+  children,
+  ...props
+}) {
+  const getKeyDisplay = () => {
+    if (!keyProp || typeof keyProp !== "string") return null;
+    const lowerKey = keyProp.toLowerCase();
+    if (type === "mac") {
+      return macKeyMap[lowerKey] || keyProp;
+    }
+    return windowsKeyMap[lowerKey] || keyProp.charAt(0).toUpperCase() + keyProp.slice(1);
+  };
+  const renderContent = () => {
+    if (children !== void 0 && children !== null && children !== "") {
+      return children;
+    }
+    return getKeyDisplay() || keyProp || "";
+  };
+  return /* @__PURE__ */ jsx4(
+    "kbd",
+    {
+      className: "inline-flex items-center justify-center px-2 py-1 mx-0.5 text-xs font-mono font-medium text-foreground bg-secondary/70 border rounded-md",
+      ...props,
+      children: renderContent()
+    }
+  );
+}
+
+// src/core/components/Link.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function isUnsafeHref(href) {
+  const normalized = href.trim().toLowerCase();
+  return normalized.startsWith("javascript:") || normalized.startsWith("data:") || normalized.startsWith("vbscript:");
+}
+function Link({ href, target, rel, ...props }) {
+  if (!href) return null;
+  if (isUnsafeHref(href)) return null;
+  const isExternal = /^https?:\/\//.test(href);
+  return /* @__PURE__ */ jsx5(
+    "a",
+    {
+      href,
+      ...props,
+      target: target ?? (isExternal ? "_blank" : void 0),
+      rel: rel ?? (isExternal ? "noopener noreferrer" : void 0)
+    }
+  );
+}
+
+// src/core/components/Note.tsx
+import { cva } from "class-variance-authority";
+import {
+  AlertTriangle,
+  CheckCircle2,
+  Info,
+  ShieldAlert
+} from "lucide-react";
+
+// src/core/utils/cn.ts
+import { clsx as clsx3 } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx3(inputs));
+}
+
+// src/core/components/Note.tsx
+import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+var noteVariants = cva(
+  "relative w-full rounded-lg border border-l-4 p-4 mb-4 [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground",
+  {
+    variants: {
+      variant: {
+        note: "bg-muted/30 border-border border-l-primary/50 text-foreground [&>svg]:text-primary",
+        danger: "border-destructive/20 border-l-destructive/60 bg-destructive/5 text-destructive [&>svg]:text-destructive dark:border-destructive/30",
+        warning: "border-orange-500/20 border-l-orange-500/60 bg-orange-500/5 text-orange-600 dark:text-orange-400 [&>svg]:text-orange-600 dark:[&>svg]:text-orange-400",
+        success: "border-emerald-500/20 border-l-emerald-500/60 bg-emerald-500/5 text-emerald-600 dark:text-emerald-400 [&>svg]:text-emerald-600 dark:[&>svg]:text-emerald-400"
+      }
+    },
+    defaultVariants: {
+      variant: "note"
+    }
+  }
+);
+var iconMap = {
+  note: Info,
+  danger: ShieldAlert,
+  warning: AlertTriangle,
+  success: CheckCircle2
+};
+function Note({
+  className,
+  title = "Note",
+  type = "note",
+  children,
+  ...props
+}) {
+  const Icon = iconMap[type] || Info;
+  return /* @__PURE__ */ jsxs3("div", { className: cn(noteVariants({ variant: type }), className), ...props, children: [
+    /* @__PURE__ */ jsx6(Icon, { className: "h-5 w-5" }),
+    /* @__PURE__ */ jsxs3("div", { className: "pl-8", children: [
+      /* @__PURE__ */ jsx6("h5", { className: "mb-1 font-medium leading-none tracking-tight", children: title }),
+      /* @__PURE__ */ jsx6("div", { className: "text-sm [&_p]:leading-relaxed opacity-90", children })
+    ] })
+  ] });
+}
+
+// src/core/components/Release.tsx
+import { Children } from "react";
+import {
+  AlertTriangle as AlertTriangle2,
+  PlusCircle,
+  Wrench,
+  XCircle,
+  Zap
+} from "lucide-react";
+import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
+function Release({ version, title, date, children }) {
+  return /* @__PURE__ */ jsxs4("div", { className: "mb-16 group", children: [
+    /* @__PURE__ */ jsxs4("div", { className: "flex items-center gap-3 mt-6 mb-2", children: [
+      /* @__PURE__ */ jsxs4(
+        "div",
+        {
+          id: version,
+          className: "inline-flex items-center rounded-full border border-primary/20 bg-primary/10 px-3 py-1 text-sm font-semibold text-primary transition-colors hover:bg-primary/15 scroll-m-20 backdrop-blur-sm",
+          children: [
+            "v",
+            version
+          ]
+        }
+      ),
+      date && /* @__PURE__ */ jsxs4("div", { className: "flex items-center gap-3 text-sm font-medium text-muted-foreground", children: [
+        /* @__PURE__ */ jsx7("span", { className: "h-1 w-1 rounded-full bg-muted-foreground/30" }),
+        /* @__PURE__ */ jsx7("time", { dateTime: date, children: new Date(date).toLocaleDateString("en-US", {
+          year: "numeric",
+          month: "long",
+          day: "numeric"
+        }) })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx7("h3", { className: "text-2xl font-bold text-foreground/90 mb-6 mt-0!", children: title }),
+    /* @__PURE__ */ jsx7("div", { className: "space-y-8", children })
+  ] });
+}
+var typeConfig = {
+  added: {
+    label: "Added",
+    className: "bg-green-100 dark:bg-green-900/50 text-green-700 dark:text-green-300",
+    icon: PlusCircle
+  },
+  fixed: {
+    label: "Fixed",
+    className: "bg-yellow-100 dark:bg-yellow-900/50 text-yellow-700 dark:text-yellow-300",
+    icon: Wrench
+  },
+  improved: {
+    label: "Improved",
+    className: "bg-cyan-100 dark:bg-cyan-900/50 text-cyan-700 dark:text-cyan-300",
+    icon: Zap
+  },
+  deprecated: {
+    label: "Deprecated",
+    className: "bg-orange-100 dark:bg-orange-900/50 text-orange-700 dark:text-orange-300",
+    icon: AlertTriangle2
+  },
+  removed: {
+    label: "Removed",
+    className: "bg-pink-100 dark:bg-pink-900/50 text-pink-700 dark:text-pink-300",
+    icon: XCircle
+  }
+};
+function Changes({ type, children }) {
+  const config = typeConfig[type] || typeConfig.added;
+  return /* @__PURE__ */ jsxs4("div", { className: "space-y-3 mb-8", children: [
+    /* @__PURE__ */ jsx7("div", { className: "flex items-center gap-2", children: /* @__PURE__ */ jsxs4(
+      "div",
+      {
+        className: cn(
+          "px-3 py-1 rounded-full text-sm font-medium flex items-center gap-1.5",
+          config.className
+        ),
+        children: [
+          /* @__PURE__ */ jsx7(config.icon, { className: "h-3.5 w-3.5" }),
+          /* @__PURE__ */ jsx7("span", { children: config.label })
+        ]
+      }
+    ) }),
+    /* @__PURE__ */ jsx7("ul", { className: "list-none pl-0 space-y-2 text-foreground/80", children: Children.map(children, (child, index) => {
+      const processedChild = typeof child === "string" ? child.trim().replace(/^[-*]\s+/, "") : child;
+      return /* @__PURE__ */ jsx7("li", { className: "leading-relaxed", children: processedChild }, index);
+    }) })
+  ] });
+}
+
+// src/core/components/Stepper.tsx
+import clsx4 from "clsx";
+import { Children as Children2 } from "react";
+import { jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
+function Stepper({ children }) {
+  const length = Children2.count(children);
+  return /* @__PURE__ */ jsx8("div", { className: "flex flex-col", children: Children2.map(children, (child, index) => {
+    return /* @__PURE__ */ jsxs5(
+      "div",
+      {
+        className: cn(
+          "border-l border-muted pl-9 ml-3 relative",
+          clsx4({
+            "pb-5 ": index < length - 1
+          })
+        ),
+        children: [
+          /* @__PURE__ */ jsx8("div", { className: "bg-muted text-muted-foreground w-8 h-8 text-xs font-medium rounded-md border border-border/50 flex items-center justify-center absolute -left-4 font-code", children: index + 1 }),
+          child
+        ]
+      }
+    );
+  }) });
+}
+function StepperItem({
+  children,
+  title
+}) {
+  return /* @__PURE__ */ jsxs5("div", { className: "pt-0.5", children: [
+    /* @__PURE__ */ jsx8("h4", { className: "mt-0", children: title }),
+    /* @__PURE__ */ jsx8("div", { children })
+  ] });
+}
+
+// src/core/components/Youtube.tsx
+import { jsx as jsx9 } from "react/jsx-runtime";
+var Youtube = ({ videoId, className }) => {
+  return /* @__PURE__ */ jsx9("div", { className: `youtube ${className || ""}`, children: /* @__PURE__ */ jsx9(
+    "iframe",
+    {
+      src: `https://www.youtube.com/embed/${videoId}?rel=0&modestbranding=1&showinfo=0&autohide=1&controls=1`,
+      title: "YouTube video player",
+      frameBorder: "0",
+      allow: "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture",
+      allowFullScreen: true
+    }
+  ) });
+};
+
+// src/core/server.ts
+function createCoreServerMdxComponents() {
+  return {
+    Button,
+    Card,
+    CardGroup,
+    Kbd,
+    kbd: Kbd,
+    Note,
+    Stepper,
+    StepperItem,
+    Youtube,
+    Release,
+    Changes,
+    a: Link
+  };
+}
+export {
+  Button,
+  Card,
+  CardGroup,
+  Changes,
+  Kbd,
+  Link,
+  Note,
+  Release,
+  Stepper,
+  StepperItem,
+  Youtube,
+  createCoreServerMdxComponents
+};

package/package.json

@@ -0,0 +1,98 @@
+{
+    "name": "@docubook/mdx",
+    "version": "1.0.0",
+    "description": "Framework-agnostic MDX components for React with adapters.",
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs",
+            "default": "./dist/index.js"
+        },
+        "./core/client": {
+            "types": "./dist/core/index.d.ts",
+            "import": "./dist/core/index.js",
+            "require": "./dist/core/index.cjs",
+            "default": "./dist/core/index.js"
+        },
+        "./core/server": {
+            "types": "./dist/core/server.d.ts",
+            "import": "./dist/core/server.js",
+            "require": "./dist/core/server.cjs",
+            "default": "./dist/core/server.js"
+        },
+        "./next": {
+            "types": "./dist/adapters/next/index.d.ts",
+            "import": "./dist/adapters/next/index.js",
+            "require": "./dist/adapters/next/index.cjs",
+            "default": "./dist/adapters/next/index.js"
+        },
+        "./react-router": {
+            "types": "./dist/adapters/react-router/index.d.ts",
+            "import": "./dist/adapters/react-router/index.js",
+            "require": "./dist/adapters/react-router/index.cjs",
+            "default": "./dist/adapters/react-router/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "sideEffects": false,
+    "scripts": {
+        "build": "tsup src/index.ts src/core/index.ts src/core/server.ts src/adapters/next/index.tsx src/adapters/react-router/index.tsx --format esm,cjs --dts --clean --splitting false",
+        "clean": "rm -rf dist",
+        "prepublishOnly": "pnpm run clean && pnpm run build"
+    },
+    "keywords": [
+        "docubook",
+        "mdx",
+        "react",
+        "nextjs",
+        "react-router",
+        "documentation",
+        "docs framework"
+    ],
+    "homepage": "https://docubook.pro/",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/DocuBook/docubook"
+    },
+    "author": "wildan.nrs",
+    "author-url": "https://wildan.dev",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "peerDependencies": {
+        "react": ">=18",
+        "react-dom": ">=18",
+        "next": ">=14",
+        "react-router-dom": ">=6"
+    },
+    "peerDependenciesMeta": {
+        "next": {
+            "optional": true
+        },
+        "react-router-dom": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "class-variance-authority": "^0.7.1",
+        "clsx": "^2.1.1",
+        "lucide-react": "^0.511.0",
+        "react-icons": "^5.6.0",
+        "tailwind-merge": "^2.6.1"
+    },
+    "devDependencies": {
+        "@types/react": "19.2.8",
+        "@types/react-dom": "19.2.3",
+        "react-router-dom": "^7.13.2",
+        "tsup": "^8.5.0",
+        "typescript": "^5.9.3"
+    }
+}