stropress 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { build, dev } from "astro";
+import { program } from "commander";
+import fs from "fs-extra";
+import { watch } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+var currentFilePath = fileURLToPath(import.meta.url);
+var currentDir = path.dirname(currentFilePath);
+var run = async (mode, options) => {
+  const cwd = process.cwd();
+  const docsDir = path.resolve(cwd, options.dir || "docs");
+  const configPath = path.join(docsDir, "config.json");
+  const themeDir = await resolveThemeDir();
+  const themeContentDir = path.join(themeDir, "src/content/docs");
+  const loadAstroConfig = async (config2) => {
+    const astroConfigPath = await writeAstroConfig({
+      cwd,
+      themeDir,
+      config: config2
+    });
+    const astroConfigModule = await import(`${pathToFileURL(astroConfigPath).href}?t=${Date.now()}`);
+    return astroConfigModule.default;
+  };
+  if (!await fs.pathExists(themeDir)) {
+    throw new Error(`Missing theme directory: ${themeDir}`);
+  }
+  if (!await fs.pathExists(docsDir)) {
+    throw new Error(`Missing docs directory: ${docsDir}`);
+  }
+  const docSources = await collectDocSources(docsDir);
+  if (docSources.length === 0) {
+    throw new Error("No supported docs files found under docs/. Add .md/.mdx content or index.astro homepage files.");
+  }
+  await syncDocs(docsDir, themeContentDir);
+  if (mode === "dev") {
+    let devServer;
+    let restarting = false;
+    let pendingRestart = false;
+    const startDevServer = async () => {
+      const config2 = await readConfig(configPath);
+      const astroConfig2 = await loadAstroConfig(config2);
+      devServer = await dev({
+        ...astroConfig2,
+        root: themeDir,
+        site: astroConfig2.site,
+        devOutput: "static"
+      });
+    };
+    const restartDevServer = async () => {
+      if (restarting) {
+        pendingRestart = true;
+        return;
+      }
+      restarting = true;
+      try {
+        console.log("[stropress] Detected config.json changes. Restarting dev server...");
+        if (devServer) {
+          await devServer.stop();
+        }
+        await startDevServer();
+        console.log("[stropress] Dev server restarted.");
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[stropress] Failed to restart dev server: ${message}`);
+      } finally {
+        restarting = false;
+        if (pendingRestart) {
+          pendingRestart = false;
+          restartDevServer();
+        }
+      }
+    };
+    await startDevServer();
+    const stopWatching = watchDocsForChanges({
+      sourceDir: docsDir,
+      targetDir: themeContentDir,
+      onConfigChange: restartDevServer
+    });
+    const shutdown = () => {
+      stopWatching();
+      if (devServer) {
+        devServer.stop();
+      }
+    };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+    return;
+  }
+  const config = await readConfig(configPath);
+  const astroConfig = await loadAstroConfig(config);
+  await build({
+    ...astroConfig,
+    root: themeDir,
+    site: astroConfig.site,
+    devOutput: "static"
+  });
+};
+var resolveThemeDir = async () => {
+  const candidates = [
+    path.resolve(currentDir, "theme-default"),
+    path.resolve(currentDir, "../theme-default"),
+    path.resolve(currentDir, "../../themes/default")
+  ];
+  for (const candidate of candidates) {
+    if (await fs.pathExists(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error("Missing bundled default theme");
+};
+var collectDocSources = async (currentDir2) => {
+  const entries = await fs.readdir(currentDir2, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    if (entry.name === "config.json") {
+      continue;
+    }
+    const fullPath = path.join(currentDir2, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await collectDocSources(fullPath));
+      continue;
+    }
+    if (isSupportedDocFile(entry.name, fullPath)) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+};
+var isSupportedDocFile = (fileName, filePath) => {
+  if (/\.(md|mdx)$/i.test(fileName)) {
+    return true;
+  }
+  if (fileName === "index.css" && isRootCustomStyleFile(filePath)) {
+    return true;
+  }
+  return fileName === "index.astro" && isHomepageAstroFile(filePath);
+};
+var isHomepageAstroFile = (filePath) => {
+  const normalizedPath = filePath.replaceAll("\\", "/");
+  return /(^|\/)index\.astro$/i.test(normalizedPath);
+};
+var isRootCustomStyleFile = (filePath) => {
+  const normalizedPath = filePath.replaceAll("\\", "/");
+  return /(^|\/)docs\/index\.css$/i.test(normalizedPath);
+};
+var readConfig = async (configPath) => {
+  if (!await fs.pathExists(configPath)) {
+    return {};
+  }
+  return fs.readJson(configPath);
+};
+var syncDocs = async (sourceDir, targetDir) => {
+  await fs.emptyDir(targetDir);
+  await copyDocsRecursive(sourceDir, targetDir);
+};
+var watchDocsForChanges = (input) => {
+  let timer;
+  let configTimer;
+  let syncing = false;
+  let pending = false;
+  const runSync = async () => {
+    if (syncing) {
+      pending = true;
+      return;
+    }
+    syncing = true;
+    try {
+      await syncDocs(input.sourceDir, input.targetDir);
+      console.log("[stropress] Synced docs changes.");
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(`[stropress] Failed to sync docs changes: ${message}`);
+    } finally {
+      syncing = false;
+      if (pending) {
+        pending = false;
+        runSync();
+      }
+    }
+  };
+  const queueSync = () => {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      runSync();
+    }, 120);
+  };
+  const queueConfigRestart = () => {
+    if (configTimer) {
+      clearTimeout(configTimer);
+    }
+    configTimer = setTimeout(() => {
+      input.onConfigChange?.();
+    }, 160);
+  };
+  const watcher = watch(input.sourceDir, { recursive: true }, (_eventType, filename) => {
+    const changedPath = typeof filename === "string" ? filename : "";
+    const normalizedPath = changedPath.replaceAll("\\", "/");
+    if (!changedPath) {
+      queueSync();
+      return;
+    }
+    if (normalizedPath === "config.json") {
+      queueConfigRestart();
+      return;
+    }
+    if (!/\.(md|mdx)$/i.test(normalizedPath) && normalizedPath !== "index.css" && !(normalizedPath.endsWith("/index.astro") || normalizedPath === "index.astro")) {
+      return;
+    }
+    queueSync();
+  });
+  console.log(`[stropress] Watching docs changes: ${input.sourceDir}`);
+  return () => {
+    watcher.close();
+    if (timer) {
+      clearTimeout(timer);
+    }
+    if (configTimer) {
+      clearTimeout(configTimer);
+    }
+  };
+};
+var copyDocsRecursive = async (sourceDir, targetDir) => {
+  const entries = await fs.readdir(sourceDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === "config.json") {
+      continue;
+    }
+    const sourcePath = path.join(sourceDir, entry.name);
+    const targetPath = path.join(targetDir, entry.name);
+    if (entry.isDirectory()) {
+      await fs.ensureDir(targetPath);
+      await copyDocsRecursive(sourcePath, targetPath);
+      continue;
+    }
+    if (isSupportedDocFile(entry.name, sourcePath)) {
+      await fs.ensureDir(path.dirname(targetPath));
+      await fs.copyFile(sourcePath, targetPath);
+    }
+  }
+};
+var writeAstroConfig = async (input) => {
+  await fs.remove(path.join(input.themeDir, ".daoke"));
+  const runtimeDir = path.join(input.themeDir, ".stropress");
+  const astroConfigPath = path.join(runtimeDir, "astro.config.mjs");
+  const serializedConfig = JSON.stringify(input.config);
+  const siteUrl = resolveSiteUrl(input.config);
+  const codeTheme = input.config.markdown?.codeTheme;
+  const shikiConfig = codeTheme ? `,
+    shikiConfig: {
+      theme: ${JSON.stringify(codeTheme)}
+    }` : "";
+  await fs.ensureDir(runtimeDir);
+  const content = `import { defineConfig } from "astro/config";
+import mdx from "@astrojs/mdx";
+import remarkGithubAlerts from "remark-github-alerts";
+
+export default defineConfig({
+  outDir: ${JSON.stringify(path.join(input.cwd, "dist"))},
+  devToolbar: {
+    enabled: false
+  },
+  markdown: {
+    remarkPlugins: [remarkGithubAlerts]${shikiConfig}
+  },
+  integrations: [
+    mdx({
+      remarkPlugins: [remarkGithubAlerts]
+    })
+  ],
+  site: ${JSON.stringify(siteUrl)},
+  vite: {
+    define: {
+      "import.meta.env.STROPRESS_SITE_CONFIG": ${JSON.stringify(serializedConfig)}
+    }
+  }
+});
+`;
+  await fs.writeFile(astroConfigPath, content, "utf8");
+  return astroConfigPath;
+};
+var resolveSiteUrl = (config) => {
+  const configuredUrl = config.site?.url?.trim();
+  if (!configuredUrl) {
+    return "http://localhost:4321";
+  }
+  try {
+    return new URL(configuredUrl).toString();
+  } catch {
+    throw new Error(`Invalid site.url in config.json: ${configuredUrl}. Expected a full URL such as https://docs.example.com`);
+  }
+};
+program.name("stropress").description("Build Astro docs from a local docs directory");
+var registerCommand = (name) => {
+  program.command(name).option("--dir <dir>", "Directory containing docs content and config.json", "docs").action(async (options) => run(name, options));
+};
+registerCommand("dev");
+registerCommand("build");
+program.parseAsync(process.argv).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[stropress] ${message}`);
+  process.exitCode = 1;
+});

package/dist/theme-default/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@stropress/theme-default",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@astrojs/mdx": "5.0.3",
+    "@fontsource/inter": "^5.2.8",
+    "@fontsource/jetbrains-mono": "^5.2.8",
+    "@lucide/astro": "^1.7.0",
+    "@resvg/resvg-js": "^2.6.2",
+    "astro": "6.1.3",
+    "copy-to-clipboard": "^3.3.3",
+    "minisearch": "^7.2.0",
+    "postcss-nesting": "^14.0.0",
+    "remark-github-alerts": "^0.1.1",
+    "satori": "^0.26.0",
+    "satori-html": "^0.3.2"
+  }
+}

package/dist/theme-default/postcss.config.mjs

@@ -0,0 +1,5 @@
+import postcssNesting from "postcss-nesting";
+
+export default {
+  plugins: [postcssNesting()],
+};

package/dist/theme-default/src/components/BaseHead.astro

@@ -0,0 +1,53 @@
+---
+interface Props {
+  title: string;
+  description: string;
+  lang?: string;
+  canonical?: string;
+  image?: string;
+  noindex?: boolean;
+  ogType?: "website" | "article";
+}
+
+const {
+  title,
+  description,
+  lang = "en-US",
+  canonical,
+  image,
+  noindex = false,
+  ogType = "website",
+} = Astro.props;
+
+const site = Astro.site;
+const canonicalUrl =
+  canonical ||
+  (site ? new URL(Astro.url.pathname, site).toString() : undefined);
+const imageUrl = image
+  ? site
+    ? new URL(image, site).toString()
+    : image
+  : undefined;
+const locale = lang.replace("-", "_");
+const twitterCard = imageUrl ? "summary_large_image" : "summary";
+---
+
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>{title}</title>
+<meta name="description" content={description} />
+<meta name="robots" content={noindex ? "noindex, nofollow" : "index, follow"} />
+
+{canonicalUrl && <link rel="canonical" href={canonicalUrl} />}
+
+<meta property="og:type" content={ogType} />
+<meta property="og:title" content={title} />
+<meta property="og:description" content={description} />
+<meta property="og:locale" content={locale} />
+{canonicalUrl && <meta property="og:url" content={canonicalUrl} />}
+{imageUrl && <meta property="og:image" content={imageUrl} />}
+
+<meta name="twitter:card" content={twitterCard} />
+<meta name="twitter:title" content={title} />
+<meta name="twitter:description" content={description} />
+{imageUrl && <meta name="twitter:image" content={imageUrl} />}

package/dist/theme-default/src/components/DocToc.astro

@@ -0,0 +1,111 @@
+---
+interface TocItem {
+  depth: number;
+  slug: string;
+  text: string;
+}
+
+interface Props {
+  items?: TocItem[];
+}
+
+const { items = [] } = Astro.props;
+---
+
+{
+  items.length > 0 && (
+    <aside class="doc-toc" aria-label="Table of contents">
+      <p class="doc-toc-title">On this page</p>
+      <ul class="doc-toc-list">
+        {items.map((heading) => (
+          <li
+            class:list={["doc-toc-item", `depth-${heading.depth}`]}
+            data-target-id={heading.slug}
+            data-state="inactive"
+          >
+            <a href={`#${heading.slug}`} class="doc-toc-link">
+              {heading.text}
+            </a>
+          </li>
+        ))}
+      </ul>
+    </aside>
+  )
+}
+
+<script>
+  import { setupDocToc } from "../scripts/doc-toc";
+
+  setupDocToc();
+</script>
+
+<style is:global>
+  .doc-toc {
+    display: none;
+  }
+
+  .doc-toc-title {
+    margin: 0 0 0.9rem;
+    font-size: 0.78rem;
+    font-weight: 700;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    color: rgba(var(--muted-color) / 1);
+  }
+
+  .doc-toc-list {
+    position: relative;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    display: flex;
+    flex-direction: column;
+    gap: 0.28rem;
+  }
+
+  .doc-toc-list::before {
+    content: "";
+    position: absolute;
+    top: 0;
+    left: 0;
+    bottom: 0;
+    width: 2px;
+    background: rgba(var(--border-color) / 0.4);
+  }
+
+  .doc-toc-item.depth-3 {
+    padding-left: 0.8rem;
+  }
+
+  .doc-toc-item {
+    border-left: 2px solid transparent;
+  }
+
+  .doc-toc-item:hover,
+  .doc-toc-item[data-state="active"] {
+    color: rgba(var(--foreground-color) / 1);
+    border-color: rgba(var(--foreground-color) / 1);
+  }
+
+  .doc-toc-link {
+    display: block;
+    padding: 0.2rem 0.65rem;
+    text-decoration: none;
+    line-height: 1.5;
+    color: rgba(var(--muted-color) / 1);
+    transition:
+      color 0.14s ease,
+      border-color 0.14s ease;
+  }
+
+  @media (min-width: 1200px) {
+    .doc-toc {
+      display: block;
+      position: sticky;
+      top: 5.7rem;
+      max-height: calc(100vh - 6.2rem);
+      overflow: auto;
+      padding: 0.3rem 0 0;
+    }
+  }
+</style>

package/dist/theme-default/src/components/GithubIcon.astro

@@ -0,0 +1,35 @@
+---
+interface Props {
+  class?: string;
+  color?: string;
+  size?: number | string;
+  title?: string;
+  "aria-hidden"?: "true" | "false";
+}
+
+const {
+  class: className,
+  color,
+  size,
+  title,
+  "aria-hidden": ariaHidden,
+} = Astro.props;
+
+const resolvedSize = size ?? 20;
+---
+
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width={resolvedSize}
+  height={resolvedSize}
+  fill={color ?? "currentColor"}
+  viewBox="0 0 24 24"
+  class={className}
+  aria-hidden={ariaHidden}
+  role={title ? "img" : undefined}
+  aria-label={title}
+>
+  <path
+    d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"
+  ></path>
+</svg>