blodemd 0.1.0 → 0.2.0

package/docs/components/ui/skeleton.tsx

@@ -1,11 +0,0 @@
-import { cn } from "@/lib/utils";
-
-const Skeleton = ({ className, ...props }: React.ComponentProps<"div">) => (
-  <div
-    data-slot="skeleton"
-    className={cn("animate-pulse rounded-md bg-accent", className)}
-    {...props}
-  />
-);
-
-export { Skeleton };

package/docs/components/ui/switch.tsx

@@ -1,32 +0,0 @@
-"use client";
-
-import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-const Switch = React.forwardRef<
-  React.ElementRef<typeof SwitchPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>
->(({ className, ...props }, ref) => (
-  <SwitchPrimitive.Root
-    className={cn(
-      "peer inline-flex h-[24px] w-[42px] shrink-0 cursor-pointer items-center rounded-full transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background data-disabled:cursor-not-allowed data-checked:bg-primary data-unchecked:bg-input data-disabled:opacity-50 data-unchecked:hover:bg-input-hover",
-      className
-    )}
-    data-slot="switch"
-    ref={ref}
-    {...props}
-  >
-    <SwitchPrimitive.Thumb
-      className={cn(
-        "pointer-events-none block size-[18px] rounded-full bg-card shadow-lg ring-0 transition-transform data-checked:translate-x-[21px] data-unchecked:translate-x-[3px] dark:bg-card-foreground"
-      )}
-      data-slot="switch-thumb"
-    />
-  </SwitchPrimitive.Root>
-));
-
-Switch.displayName = SwitchPrimitive.Root.displayName;
-
-export { Switch };

package/docs/components/ui/tabs.tsx

@@ -1,138 +0,0 @@
-"use client";
-
-import { Tabs as TabsPrimitive } from "@base-ui/react/tabs";
-import { cva } from "class-variance-authority";
-import type { VariantProps } from "class-variance-authority";
-import mergeRefs from "merge-refs";
-import * as React from "react";
-
-import { useTabObserver } from "@/hooks/use-tab-observer";
-import { cn } from "@/lib/utils";
-
-const Tabs = ({
-  className,
-  orientation = "horizontal",
-  ...props
-}: React.ComponentProps<typeof TabsPrimitive.Root>) => (
-  <TabsPrimitive.Root
-    className={cn("group/tabs flex gap-2 data-horizontal:flex-col", className)}
-    data-orientation={orientation}
-    data-slot="tabs"
-    orientation={orientation}
-    {...props}
-  />
-);
-
-const tabsListVariants = cva(
-  "group/tabs-list relative isolate inline-flex w-fit items-center justify-center rounded-lg p-[3px] text-muted-foreground data-[variant=line]:rounded-none group-data-horizontal/tabs:h-8 group-data-vertical/tabs:h-fit group-data-vertical/tabs:flex-col",
-  {
-    defaultVariants: {
-      variant: "default",
-    },
-    variants: {
-      variant: {
-        default: "bg-muted",
-        line: "gap-1 bg-transparent",
-      },
-    },
-  }
-);
-
-const TabsList = ({
-  className,
-  variant = "default",
-  ref,
-  ...props
-}: React.ComponentProps<typeof TabsPrimitive.List> &
-  VariantProps<typeof tabsListVariants>) => {
-  const [indicatorStyle, setIndicatorStyle] = React.useState({
-    height: 0,
-    left: 0,
-    top: 0,
-    width: 0,
-  });
-  const [hasIndicatorPosition, setHasIndicatorPosition] = React.useState(false);
-  const [canAnimateIndicator, setCanAnimateIndicator] = React.useState(false);
-  const hasInitializedIndicator = React.useRef(false);
-  const { listRef } = useTabObserver({
-    onActiveTabChange: (_, activeTab) => {
-      setIndicatorStyle({
-        height: activeTab.offsetHeight,
-        left: activeTab.offsetLeft,
-        top: activeTab.offsetTop,
-        width: activeTab.offsetWidth,
-      });
-
-      if (!hasInitializedIndicator.current) {
-        hasInitializedIndicator.current = true;
-        setHasIndicatorPosition(true);
-        requestAnimationFrame(() => {
-          setCanAnimateIndicator(true);
-        });
-        return;
-      }
-
-      setHasIndicatorPosition(true);
-    },
-  });
-
-  return (
-    <TabsPrimitive.List
-      className={cn(tabsListVariants({ variant }), className)}
-      data-slot="tabs-list"
-      data-variant={variant}
-      ref={mergeRefs(ref, listRef)}
-      {...props}
-    >
-      {variant === "default" ? (
-        <span
-          aria-hidden="true"
-          className={cn(
-            "pointer-events-none absolute top-0 left-0 z-0 rounded-md bg-background shadow-sm",
-            canAnimateIndicator
-              ? "transition-[width,height,transform,opacity] duration-300"
-              : "transition-none",
-            hasIndicatorPosition ? "opacity-100" : "opacity-0"
-          )}
-          style={{
-            height: `${indicatorStyle.height}px`,
-            transform: `translate(${indicatorStyle.left}px, ${indicatorStyle.top}px)`,
-            transitionTimingFunction: "cubic-bezier(0.65, 0, 0.35, 1)",
-            width: `${indicatorStyle.width}px`,
-          }}
-        />
-      ) : null}
-      {props.children}
-    </TabsPrimitive.List>
-  );
-};
-
-const TabsTrigger = ({
-  className,
-  ...props
-}: React.ComponentProps<typeof TabsPrimitive.Tab>) => (
-  <TabsPrimitive.Tab
-    className={cn(
-      "relative z-10 inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 whitespace-nowrap rounded-md border border-transparent px-1.5 py-0.5 font-medium text-foreground/60 text-sm transition-all hover:text-foreground focus-visible:border-ring focus-visible:outline-1 focus-visible:outline-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 group-data-vertical/tabs:w-full group-data-vertical/tabs:justify-start group-data-[variant=line]/tabs-list:data-active:shadow-none dark:text-muted-foreground dark:hover:text-foreground [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0",
-      "group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent dark:group-data-[variant=line]/tabs-list:data-active:border-transparent dark:group-data-[variant=line]/tabs-list:data-active:bg-transparent",
-      "data-active:text-foreground group-data-[variant=default]/tabs-list:data-active:bg-transparent dark:data-active:text-foreground group-data-[variant=default]/tabs-list:dark:data-active:border-transparent group-data-[variant=default]/tabs-list:dark:data-active:bg-transparent",
-      "after:absolute after:bg-foreground after:opacity-0 after:transition-opacity group-data-horizontal/tabs:after:inset-x-0 group-data-vertical/tabs:after:inset-y-0 group-data-vertical/tabs:after:-right-1 group-data-horizontal/tabs:after:bottom-[-5px] group-data-horizontal/tabs:after:h-0.5 group-data-vertical/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
-      className
-    )}
-    data-slot="tabs-trigger"
-    {...props}
-  />
-);
-
-const TabsContent = ({
-  className,
-  ...props
-}: React.ComponentProps<typeof TabsPrimitive.Panel>) => (
-  <TabsPrimitive.Panel
-    className={cn("flex-1 text-sm outline-none", className)}
-    data-slot="tabs-content"
-    {...props}
-  />
-);
-
-export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants };

package/docs/components/ui/theme-toggle.tsx

@@ -1,62 +0,0 @@
-"use client";
-
-import { useTheme } from "next-themes";
-import { useCallback, useEffect } from "react";
-
-export const ThemeToggle = () => {
-  const { resolvedTheme, setTheme } = useTheme();
-
-  const toggle = useCallback(() => {
-    setTheme(resolvedTheme === "dark" ? "light" : "dark");
-  }, [resolvedTheme, setTheme]);
-
-  useEffect(() => {
-    const down = (e: KeyboardEvent) => {
-      if ((e.key === "d" || e.key === "D") && !e.metaKey && !e.ctrlKey) {
-        if (
-          (e.target instanceof HTMLElement && e.target.isContentEditable) ||
-          e.target instanceof HTMLInputElement ||
-          e.target instanceof HTMLTextAreaElement ||
-          e.target instanceof HTMLSelectElement
-        ) {
-          return;
-        }
-        e.preventDefault();
-        toggle();
-      }
-    };
-    document.addEventListener("keydown", down);
-    return () => document.removeEventListener("keydown", down);
-  }, [toggle]);
-
-  return (
-    <button
-      aria-label="Toggle theme"
-      className="inline-flex size-8 items-center justify-center rounded-md hover:bg-accent hover:text-accent-foreground"
-      onClick={toggle}
-      type="button"
-    >
-      <svg
-        aria-hidden="true"
-        className="size-4.5"
-        fill="none"
-        height="24"
-        stroke="currentColor"
-        strokeLinecap="round"
-        strokeLinejoin="round"
-        strokeWidth="2"
-        viewBox="0 0 24 24"
-        width="24"
-        xmlns="http://www.w3.org/2000/svg"
-      >
-        <path d="M0 0h24v24H0z" fill="none" stroke="none" />
-        <path d="M12 12m-9 0a9 9 0 1 0 18 0a9 9 0 1 0 -18 0" />
-        <path d="M12 3l0 18" />
-        <path d="M12 9l4.65 -4.65" />
-        <path d="M12 14.3l7.37 -7.37" />
-        <path d="M12 19.6l8.85 -8.85" />
-      </svg>
-      <span className="sr-only">Toggle theme</span>
-    </button>
-  );
-};

package/docs/components/ui/tooltip.tsx

@@ -1,53 +0,0 @@
-"use client";
-
-import { Tooltip as TooltipPrimitive } from "radix-ui";
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-const TooltipProvider = ({
-  delayDuration = 0,
-  ...props
-}: React.ComponentProps<typeof TooltipPrimitive.Provider>) => (
-  <TooltipPrimitive.Provider
-    data-slot="tooltip-provider"
-    delayDuration={delayDuration}
-    {...props}
-  />
-);
-
-const Tooltip = ({
-  ...props
-}: React.ComponentProps<typeof TooltipPrimitive.Root>) => (
-  <TooltipPrimitive.Root data-slot="tooltip" {...props} />
-);
-
-const TooltipTrigger = ({
-  ...props
-}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) => (
-  <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
-);
-
-const TooltipContent = ({
-  className,
-  sideOffset = 0,
-  children,
-  ...props
-}: React.ComponentProps<typeof TooltipPrimitive.Content>) => (
-  <TooltipPrimitive.Portal>
-    <TooltipPrimitive.Content
-      data-slot="tooltip-content"
-      sideOffset={sideOffset}
-      className={cn(
-        "z-50 w-fit origin-(--radix-tooltip-content-transform-origin) animate-in rounded-md bg-foreground px-3 py-1.5 text-xs text-balance text-background fade-in-0 zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95",
-        className
-      )}
-      {...props}
-    >
-      {children}
-      <TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground" />
-    </TooltipPrimitive.Content>
-  </TooltipPrimitive.Portal>
-);
-
-export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/docs/components/web-mcp.tsx

@@ -1,115 +0,0 @@
-"use client";
-
-// oxlint-disable require-await -- execute signatures must return Promise for WebMCP
-// oxlint-disable func-style -- exported component uses function-declaration style
-// oxlint-disable no-void -- provideContext returns a promise we intentionally discard
-
-import { useEffect } from "react";
-
-interface JSONSchemaObject {
-  type: string;
-  properties?: Record<string, unknown>;
-  required?: string[];
-  description?: string;
-  additionalProperties?: boolean;
-}
-
-interface WebMCPTool {
-  name: string;
-  description: string;
-  inputSchema: JSONSchemaObject;
-  execute: (args: Record<string, unknown>) => Promise<unknown>;
-}
-
-interface NavigatorModelContext {
-  provideContext?: (context: { tools: WebMCPTool[] }) => void | Promise<void>;
-}
-
-const buildTools = (): WebMCPTool[] => [
-  {
-    description:
-      "Return the shell command that scaffolds a new Blode.md docs site with the given project slug.",
-    execute: async ({ slug, template }) => {
-      const projectSlug = typeof slug === "string" && slug ? slug : "my-docs";
-      const variant =
-        template === "starter" || template === "minimal" ? template : "minimal";
-      return {
-        command: `npx blodemd new docs --slug ${projectSlug} --template ${variant} -y`,
-      };
-    },
-    inputSchema: {
-      additionalProperties: false,
-      properties: {
-        slug: {
-          description: "Project slug (lowercase, hyphen-separated).",
-          type: "string",
-        },
-        template: {
-          description: "Template to use: 'minimal' or 'starter'.",
-          type: "string",
-        },
-      },
-      required: ["slug"],
-      type: "object",
-    },
-    name: "blodemd_scaffold_command",
-  },
-  {
-    description:
-      "Return the shell command that deploys a local Blode.md docs directory to the given project.",
-    execute: async ({ directory, project }) => {
-      const dir =
-        typeof directory === "string" && directory ? directory : "docs";
-      const projectSlug =
-        typeof project === "string" && project ? project : "my-docs";
-      return {
-        command: `npx blodemd push ${dir} --project ${projectSlug}`,
-      };
-    },
-    inputSchema: {
-      additionalProperties: false,
-      properties: {
-        directory: {
-          description: "Local directory containing the docs.",
-          type: "string",
-        },
-        project: {
-          description: "Target Blode.md project slug.",
-          type: "string",
-        },
-      },
-      required: ["project"],
-      type: "object",
-    },
-    name: "blodemd_deploy_command",
-  },
-  {
-    description: "Open the Blode.md dashboard in the current tab.",
-    execute: async () => {
-      if (typeof window !== "undefined") {
-        window.location.assign("/app");
-      }
-      return { ok: true };
-    },
-    inputSchema: {
-      additionalProperties: false,
-      properties: {},
-      type: "object",
-    },
-    name: "blodemd_open_dashboard",
-  },
-];
-
-export function WebMcpTools() {
-  useEffect(() => {
-    const nav = navigator as Navigator & {
-      modelContext?: NavigatorModelContext;
-    };
-    if (!nav.modelContext?.provideContext) {
-      return;
-    }
-    void nav.modelContext.provideContext({ tools: buildTools() });
-  }, []);
-
-  return null;
-}

package/docs/lib/agent-skills.ts

@@ -1,48 +0,0 @@
-import { createHash } from "node:crypto";
-
-export const BLODEMD_SKILL_CONTENT = `---
-name: blodemd
-description: Scaffold, preview, and deploy beautiful MDX documentation sites with Blode.md. Use when the user wants to create a new docs site, validate their docs config, preview locally, or deploy to Blode.md. Triggers include "create docs", "deploy docs", "push docs", "preview docs", "scaffold a docs site", "set up documentation", "validate docs.json", or any task involving MDX documentation deployment.
-user-invocable: true
-argument-hint: <command> [options]
-allowed-tools: Bash(npx blodemd *), Bash(blodemd *)
----
-
-# Blode.md
-
-Scaffold, preview, and deploy MDX documentation sites from the terminal. Write locally, ship with one command. Sign in once with GitHub in your browser, no API keys ever.
-
-## Commands
-
-- \`npx blodemd login\` - Browser sign-in with GitHub
-- \`npx blodemd whoami\` - Show current authentication status
-- \`npx blodemd new [directory] --slug <project-slug> --template <minimal|starter> -y\` - Scaffold a new docs site
-- \`npx blodemd validate [dir]\` - Validate docs.json against the schema
-- \`npx blodemd dev --dir <dir> --port 3030\` - Preview locally with hot reload
-- \`npx blodemd push [dir] --project <slug>\` - Deploy a docs site
-
-## Workflow
-
-1. Verify auth with \`npx blodemd whoami\`
-2. Scaffold or locate the docs directory
-3. Validate the configuration
-4. Preview locally
-5. Deploy to Blode.md
-
-## docs.json
-
-The \`docs.json\` file is the config for a Blode.md site. It must include a \`slug\` field:
-
-\`\`\`json
-{
-  "slug": "my-project",
-  "name": "My Project"
-}
-\`\`\`
-`;
-
-export const BLODEMD_SKILL_DESCRIPTION =
-  "Scaffold, preview, and deploy beautiful MDX documentation sites with Blode.md from the CLI.";
-
-export const sha256Hex = (input: string) =>
-  createHash("sha256").update(input, "utf8").digest("hex");

package/docs/lib/api-client.ts

@@ -1,72 +0,0 @@
-import { docsApiBase } from "./env";
-
-interface ApiRequestOptions extends Omit<RequestInit, "body" | "headers"> {
-  accessToken?: string | null;
-  body?: unknown;
-  headers?: Record<string, string>;
-}
-
-export class ApiError extends Error {
-  status: number;
-  details?: unknown;
-
-  constructor(message: string, status: number, details?: unknown) {
-    super(message);
-    this.name = "ApiError";
-    this.status = status;
-    this.details = details;
-  }
-}
-
-const buildUrl = (path: string): string => {
-  if (path.startsWith("http://") || path.startsWith("https://")) {
-    return path;
-  }
-  const url = new URL(path.startsWith("/") ? path : `/${path}`, docsApiBase);
-  return url.toString();
-};
-
-export const apiFetch = async <T = unknown>(
-  path: string,
-  options: ApiRequestOptions = {}
-): Promise<T> => {
-  const { accessToken, body, headers, ...rest } = options;
-  const finalHeaders: Record<string, string> = {
-    Accept: "application/json",
-    ...headers,
-  };
-  if (accessToken) {
-    finalHeaders.Authorization = `Bearer ${accessToken}`;
-  }
-  let serializedBody: string | undefined;
-  if (body !== undefined) {
-    finalHeaders["Content-Type"] ??= "application/json";
-    serializedBody = JSON.stringify(body);
-  }
-
-  const response = await fetch(buildUrl(path), {
-    ...rest,
-    body: serializedBody,
-    headers: finalHeaders,
-  });
-
-  const text = await response.text();
-  let json: unknown;
-  if (text) {
-    try {
-      json = JSON.parse(text);
-    } catch {
-      json = text;
-    }
-  }
-
-  if (!response.ok) {
-    const message =
-      typeof json === "object" && json && "error" in json
-        ? String((json as { error: unknown }).error)
-        : `Request failed: ${response.status}`;
-    throw new ApiError(message, response.status, json);
-  }
-
-  return json as T;
-};

package/docs/lib/config.ts

@@ -1,6 +0,0 @@
-// Kept for server-side consumers in apps/docs that need platform-wide metadata
-// (e.g. MCP server card). The richer marketing config lives in apps/web.
-
-export const siteConfig = {
-  version: "0.0.9",
-} as const;

package/docs/lib/content-root.ts

@@ -1,33 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-
-const DOCS_CONFIG_FILE = "docs.json";
-
-const EXTERNAL_DOCS_ROOTS: Record<string, string> = {
-  allmd: path.join(os.homedir(), "Code/mblode/allmd/apps/docs"),
-  "dnd-grid": path.join(os.homedir(), "Code/mblode/dnd-grid/apps/docs"),
-  donebear: path.join(os.homedir(), "Code/donebear/donebear/apps/docs"),
-  shareful: path.join(os.homedir(), "Code/shareful-ai/shareful-ai/apps/docs"),
-  stratasync: path.join(os.homedir(), "Code/donebear/stratasync/apps/docs"),
-};
-
-const getTenantDocsPathCandidates = (slug: string): string[] =>
-  [
-    EXTERNAL_DOCS_ROOTS[slug],
-    path.join(process.cwd(), "content", slug),
-    path.join(process.cwd(), "apps/docs/content", slug),
-  ].filter(Boolean) as string[];
-
-export const getTenantDocsPath = (slug: string): string => {
-  const candidates = getTenantDocsPathCandidates(slug);
-  const defaultLocalPath = path.join(process.cwd(), "apps/docs/content", slug);
-
-  for (const candidate of candidates) {
-    if (fs.existsSync(path.join(candidate, DOCS_CONFIG_FILE))) {
-      return candidate;
-    }
-  }
-
-  return defaultLocalPath;
-};

package/docs/lib/content-source.ts

@@ -1,70 +0,0 @@
-import type { SiteConfig, Tenant } from "@repo/models";
-import type { ContentSource } from "@repo/previewing";
-import { createBlobSource, createFsSource } from "@repo/previewing";
-
-import { getTenantDocsPath } from "./content-root";
-import { getProjectTag } from "./tenants";
-
-const ABSOLUTE_URL_REGEX = /^https?:\/\//i;
-
-const resolveAssetUrl = async (
-  source: ContentSource,
-  value?: string
-): Promise<string | undefined> => {
-  if (!value || value.startsWith("/") || ABSOLUTE_URL_REGEX.test(value)) {
-    return value;
-  }
-
-  const resolved = await source.resolveUrl?.(value);
-  return resolved ?? value;
-};
-
-export const getTenantContentSource = (tenant: Tenant): ContentSource => {
-  if (tenant.activeDeploymentManifestUrl) {
-    return createBlobSource(
-      tenant.activeDeploymentManifestUrl,
-      getProjectTag(tenant.slug)
-    );
-  }
-
-  return createFsSource(tenant.docsPath ?? getTenantDocsPath(tenant.slug));
-};
-
-export const resolveSiteConfigAssets = async (
-  config: SiteConfig,
-  source: ContentSource
-): Promise<SiteConfig> => {
-  const [favicon, fontCssUrl, darkLogo, lightLogo, ogImage] = await Promise.all(
-    [
-      resolveAssetUrl(source, config.favicon),
-      resolveAssetUrl(source, config.fonts?.cssUrl),
-      resolveAssetUrl(source, config.logo?.dark),
-      resolveAssetUrl(source, config.logo?.light),
-      resolveAssetUrl(source, config.metadata?.ogImage),
-    ]
-  );
-
-  return {
-    ...config,
-    favicon,
-    fonts: config.fonts
-      ? {
-          ...config.fonts,
-          cssUrl: fontCssUrl,
-        }
-      : config.fonts,
-    logo: config.logo
-      ? {
-          ...config.logo,
-          dark: darkLogo,
-          light: lightLogo,
-        }
-      : config.logo,
-    metadata: config.metadata
-      ? {
-          ...config.metadata,
-          ogImage,
-        }
-      : config.metadata,
-  };
-};