@marlinjai/clearify 1.9.0 → 1.11.0

package/dist/node/{chunk-PQMKRFBQ.js → chunk-PVTUVUBK.js}

@@ -1,3 +1,7 @@
+import {
+  resolveRemoteSections
+} from "./chunk-AJBCHKBP.js";
+
 // src/core/config.ts
 import { z } from "zod";
 import { resolve, basename, dirname } from "path";
@@ -15,13 +19,20 @@ var NavigationItemSchema = z.lazy(
     children: z.array(NavigationItemSchema).optional()
   })
 );
+var RemoteGitSourceSchema = z.object({
+  repo: z.string(),
+  ref: z.string().optional(),
+  path: z.string().optional(),
+  sparse: z.boolean().optional()
+});
 var SectionConfigSchema = z.object({
   label: z.string(),
   docsDir: z.string(),
   basePath: z.string().optional(),
   draft: z.boolean().optional(),
   sitemap: z.boolean().optional(),
-  exclude: z.array(z.string()).optional()
+  exclude: z.array(z.string()).optional(),
+  git: RemoteGitSourceSchema.optional()
 });
 var MermaidConfigSchema = z.object({
   strategy: z.enum(["client", "build"]).default("client")
@@ -39,7 +50,14 @@ var HubProjectSchema = z.object({
   status: z.enum(["active", "beta", "planned", "deprecated"]).default("active"),
   icon: z.string().optional(),
   tags: z.array(z.string()).optional(),
-  group: z.string().optional()
+  group: z.string().optional(),
+  mode: z.enum(["link", "embed"]).optional(),
+  git: RemoteGitSourceSchema.optional(),
+  embedSections: z.union([
+    z.literal("all"),
+    z.literal("public"),
+    z.array(z.string())
+  ]).optional()
 });
 var HubProjectPartialSchema = z.object({
   description: z.string(),
@@ -54,7 +72,8 @@ var HubProjectPartialSchema = z.object({
 }).optional();
 var HubConfigSchema = z.object({
   projects: z.array(HubProjectSchema).default([]),
-  scan: z.string().optional()
+  scan: z.string().optional(),
+  cacheDir: z.string().optional()
 }).optional();
 var ClearifyConfigSchema = z.object({
   name: z.string().default("Documentation"),
@@ -182,18 +201,25 @@ function resolveConfig(userConfig = {}, root) {
 function slugify(str) {
   return str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
-function resolveSections(config, root) {
+async function resolveSections(config, root) {
   if (config.sections && config.sections.length > 0) {
-    const sections = config.sections.map((s, i) => {
+    const hasRemote = config.sections.some((s) => s.git);
+    let resolvedInputs = config.sections;
+    if (hasRemote) {
+      const cacheDir = resolve(root, "node_modules/.cache/clearify-remote");
+      resolvedInputs = await resolveRemoteSections(config.sections, cacheDir);
+    }
+    const sections = resolvedInputs.map((s, i) => {
       const id = slugify(s.label);
       const draft = s.draft ?? false;
       const basePath = s.basePath ?? (i === 0 ? "/" : "/" + id);
       const sitemap = s.sitemap ?? !draft;
       const exclude = [...config.exclude ?? [], ...s.exclude ?? []];
+      const docsDir = s.docsDir.startsWith("/") ? s.docsDir : resolve(root, s.docsDir);
       return {
         id,
         label: s.label,
-        docsDir: resolve(root, s.docsDir),
+        docsDir,
         basePath,
         draft,
         sitemap,
@@ -222,37 +248,82 @@ function resolveSections(config, root) {
   ];
 }
 async function scanHubProjects(config, root) {
-  if (!config.hub?.scan) return config;
-  const { globbySync } = await import("globby");
-  const pattern = config.hub.scan;
-  const configPaths = globbySync(pattern, { cwd: root, absolute: true });
+  if (!config.hub?.scan && !config.hub?.projects?.some((p) => p.mode === "embed")) {
+    return config;
+  }
   const scannedProjects = [];
-  for (const configPath of configPaths) {
-    try {
-      const childConfig = await loadUserConfig(dirname(configPath));
-      if (!childConfig.hubProject) continue;
-      const name = childConfig.name ?? basename(dirname(configPath));
-      const hp = childConfig.hubProject;
-      scannedProjects.push({
-        name,
-        description: hp.description,
-        href: hp.href ?? childConfig.siteUrl,
-        repo: hp.repo,
-        status: hp.status,
-        icon: hp.icon,
-        tags: hp.tags,
-        group: hp.group
-      });
-    } catch {
+  if (config.hub?.scan) {
+    const { globbySync } = await import("globby");
+    const pattern = config.hub.scan;
+    const configPaths = globbySync(pattern, { cwd: root, absolute: true });
+    for (const configPath of configPaths) {
+      try {
+        const childConfig = await loadUserConfig(dirname(configPath));
+        if (!childConfig.hubProject) continue;
+        const name = childConfig.name ?? basename(dirname(configPath));
+        const hp = childConfig.hubProject;
+        scannedProjects.push({
+          name,
+          description: hp.description,
+          href: hp.href ?? childConfig.siteUrl,
+          repo: hp.repo,
+          status: hp.status,
+          icon: hp.icon,
+          tags: hp.tags,
+          group: hp.group
+        });
+      } catch {
+      }
     }
   }
-  const manualNames = new Set((config.hub.projects ?? []).map((p) => p.name));
+  const manualNames = new Set((config.hub?.projects ?? []).map((p) => p.name));
   const merged = [
     ...scannedProjects.filter((p) => !manualNames.has(p.name)),
-    ...config.hub.projects ?? []
+    ...config.hub?.projects ?? []
   ];
+  const embedSections = [];
+  for (const project of merged) {
+    if (project.mode !== "embed" || !project.git) continue;
+    const cacheDir = config.hub?.cacheDir ? resolve(root, config.hub.cacheDir) : resolve(root, "node_modules/.cache/clearify-remote");
+    try {
+      const { resolveRemoteSource } = await import("./core/remote.js");
+      const { localPath } = await resolveRemoteSource(project.git, cacheDir);
+      const remoteConfig = await loadUserConfig(localPath);
+      const remoteSections = remoteConfig.sections ?? [
+        { label: remoteConfig.name ?? project.name, docsDir: remoteConfig.docsDir ?? "./docs" }
+      ];
+      const filter = project.embedSections ?? "public";
+      const filtered = remoteSections.filter((s) => {
+        if (filter === "all") return true;
+        if (filter === "public") return !s.draft;
+        if (Array.isArray(filter)) return filter.includes(s.label);
+        return true;
+      });
+      for (const s of filtered) {
+        const docsDir = s.docsDir.startsWith("/") ? s.docsDir : resolve(localPath, s.docsDir);
+        const label = s.label === "Documentation" ? project.name : s.label;
+        const id = slugify(label);
+        embedSections.push({
+          label,
+          docsDir,
+          basePath: s.basePath ?? "/" + id,
+          draft: s.draft,
+          sitemap: s.sitemap,
+          exclude: s.exclude
+        });
+      }
+      console.log(`  Hub embed "${project.name}": ${filtered.length} sections pulled`);
+    } catch (err) {
+      console.warn(
+        `  \u26A0 Hub embed "${project.name}" failed:`,
+        err instanceof Error ? err.message : err
+      );
+    }
+  }
+  const finalSections = [...config.sections ?? [], ...embedSections];
   return {
     ...config,
+    ...embedSections.length > 0 ? { sections: finalSections } : {},
     hub: {
       ...config.hub,
       projects: merged

package/dist/node/{chunk-QNC5QRIO.js → chunk-QTGT76RY.js}

@@ -40,7 +40,13 @@ function scanDocs(docsDir, exclude = [], basePath = "/") {
         title: data.title ?? toTitleCase(basename(filePath, extname(filePath))),
         description: data.description,
         icon: data.icon,
-        order: data.order
+        order: data.order,
+        summary: data.summary,
+        category: data.category,
+        tags: data.tags,
+        projects: data.projects,
+        status: data.status,
+        date: data.date
       }
     };
   });
@@ -127,20 +133,35 @@ function buildRoutes(docs, sectionId) {
     ...sectionId ? { sectionId } : {}
   }));
 }
-function buildSectionData(section, changelogPath, customNavigation) {
+function buildSectionData(section, rootFiles, customNavigation) {
   const docs = scanDocs(section.docsDir, section.exclude, section.basePath);
-  if (section.basePath === "/" && changelogPath && existsSync(changelogPath)) {
-    const content = readFileSync(changelogPath, "utf-8");
-    const { data } = matter(content);
-    docs.push({
-      filePath: changelogPath,
-      routePath: "/changelog",
-      frontmatter: {
-        title: data.title ?? "Changelog",
-        description: data.description ?? "Release history",
-        order: 9999
-      }
-    });
+  if (section.basePath === "/") {
+    if (rootFiles?.changelogPath && existsSync(rootFiles.changelogPath)) {
+      const content = readFileSync(rootFiles.changelogPath, "utf-8");
+      const { data } = matter(content);
+      docs.push({
+        filePath: rootFiles.changelogPath,
+        routePath: "/changelog",
+        frontmatter: {
+          title: data.title ?? "Changelog",
+          description: data.description ?? "Release history",
+          order: 9999
+        }
+      });
+    }
+    if (rootFiles?.roadmapPath && existsSync(rootFiles.roadmapPath)) {
+      const content = readFileSync(rootFiles.roadmapPath, "utf-8");
+      const { data } = matter(content);
+      docs.push({
+        filePath: rootFiles.roadmapPath,
+        routePath: "/roadmap",
+        frontmatter: {
+          title: data.title ?? "Roadmap",
+          description: data.description ?? "Planned and upcoming features",
+          order: 9998
+        }
+      });
+    }
   }
   const nav = section.basePath === "/" && customNavigation ? customNavigation : buildNavigation(docs, section.basePath);
   const navigation = {

package/dist/node/cli/index.js

@@ -1,5 +1,21 @@
 // src/cli/index.ts
 import cac from "cac";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { readFileSync, existsSync } from "fs";
+function findPackageVersion() {
+  let dir = dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 5; i++) {
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      if (pkg.name === "clearify" || pkg.name === "@marlinjai/clearify") return pkg.version;
+    }
+    dir = dirname(dir);
+  }
+  return "0.0.0";
+}
+var version = findPackageVersion();
 var cli = cac("clearify");
 cli.command("dev", "Start development server").option("--port <port>", "Port to listen on").option("--host", "Expose to network").action(async (options) => {
   const { createServer } = await import("../node/index.js");
@@ -22,9 +38,9 @@ cli.command("init", "Scaffold a docs folder").option("--no-internal", "Skip crea
   const { init } = await import("../node/index.js");
   await init({ noInternal: options.noInternal, noClaudeRules: options.noClaudeRules });
 });
-cli.command("check", "Check for broken internal links").action(async () => {
+cli.command("check", "Check for broken internal links and frontmatter issues").option("--frontmatter", "Only run frontmatter validation (skip broken link detection)").action(async (options) => {
   const { checkLinks } = await import("../node/check.js");
-  await checkLinks();
+  await checkLinks({ frontmatterOnly: options.frontmatter });
 });
 cli.command("openapi:generate", "Generate OpenAPI spec from NestJS app").option("--module <path>", "Path to NestJS app module", { default: "./src/app.module.ts" }).option("--output <path>", "Output path for spec file", { default: "./docs/openapi.json" }).option("--title <title>", "API documentation title").option("--description <desc>", "API documentation description").option("--version <version>", "API version").action(async (options) => {
   const { generateSpec } = await import("../presets/nestjs.js");
@@ -37,5 +53,5 @@ cli.command("openapi:generate", "Generate OpenAPI spec from NestJS app").option(
   });
 });
 cli.help();
-cli.version("1.8.0");
+cli.version(version);
 cli.parse();

package/dist/node/core/config.d.ts

@@ -4,7 +4,7 @@ export { defineConfig } from '../types/index.js';
 declare const defaultConfig: ClearifyConfig;
 declare function loadUserConfig(root: string): Promise<Partial<ClearifyConfig>>;
 declare function resolveConfig(userConfig?: Partial<ClearifyConfig>, root?: string): ClearifyConfig;
-declare function resolveSections(config: ClearifyConfig, root: string): ResolvedSection[];
+declare function resolveSections(config: ClearifyConfig, root: string): Promise<ResolvedSection[]>;
 declare function scanHubProjects(config: ClearifyConfig, root: string): Promise<ClearifyConfig>;
 
 export { defaultConfig, loadUserConfig, resolveConfig, resolveSections, scanHubProjects };

package/dist/node/core/config.js

@@ -4,7 +4,8 @@ import {
   resolveConfig,
   resolveSections,
   scanHubProjects
-} from "../chunk-PQMKRFBQ.js";
+} from "../chunk-PVTUVUBK.js";
+import "../chunk-AJBCHKBP.js";
 import {
   defineConfig
 } from "../chunk-V7LLYIRO.js";

package/dist/node/core/navigation.d.ts

@@ -1,2 +1,2 @@
 import '../types/index.js';
-export { D as DocFile, S as SectionData, b as buildNavigation, a as buildRoutes, c as buildSectionData, s as scanDocs } from './search.js';
+export { D as DocFile, R as RootFileOptions, S as SectionData, b as buildNavigation, a as buildRoutes, c as buildSectionData, s as scanDocs } from './search.js';

package/dist/node/core/navigation.js

@@ -3,7 +3,7 @@ import {
   buildRoutes,
   buildSectionData,
   scanDocs
-} from "../chunk-QNC5QRIO.js";
+} from "../chunk-QTGT76RY.js";
 import "../chunk-5TD7NQIW.js";
 export {
   buildNavigation,

package/dist/node/core/remote.d.ts

@@ -0,0 +1,18 @@
+import { SectionConfig, RemoteGitSource } from '../types/index.js';
+
+interface ResolvedRemote {
+    localPath: string;
+    resolvedCommit: string;
+    cached: boolean;
+}
+/**
+ * Clone or update a git repo into the cache directory.
+ */
+declare function resolveRemoteSource(source: RemoteGitSource, cacheDir: string): Promise<ResolvedRemote>;
+/**
+ * For each section with a `git` source, clone/update the repo and rewrite
+ * `docsDir` to the absolute path inside the cached clone.
+ */
+declare function resolveRemoteSections(sections: SectionConfig[], cacheDir: string): Promise<SectionConfig[]>;
+
+export { resolveRemoteSections, resolveRemoteSource };

package/dist/node/core/remote.js

@@ -0,0 +1,8 @@
+import {
+  resolveRemoteSections,
+  resolveRemoteSource
+} from "../chunk-AJBCHKBP.js";
+export {
+  resolveRemoteSections,
+  resolveRemoteSource
+};

package/dist/node/core/search.d.ts

@@ -26,6 +26,10 @@ interface SectionData {
     routes: RouteEntry[];
     searchEntries: SearchEntry[];
 }
-declare function buildSectionData(section: ResolvedSection, changelogPath?: string, customNavigation?: NavigationItem[] | null): SectionData;
+interface RootFileOptions {
+    changelogPath?: string;
+    roadmapPath?: string;
+}
+declare function buildSectionData(section: ResolvedSection, rootFiles?: RootFileOptions, customNavigation?: NavigationItem[] | null): SectionData;
 
-export { type DocFile as D, type SectionData as S, type SearchEntry, buildRoutes as a, buildNavigation as b, buildSearchIndex, buildSectionData as c, scanDocs as s };
+export { type DocFile as D, type RootFileOptions as R, type SectionData as S, type SearchEntry, buildRoutes as a, buildNavigation as b, buildSearchIndex, buildSectionData as c, scanDocs as s };

package/dist/node/node/build.js

@@ -1,13 +1,14 @@
 import {
   buildSite
-} from "../chunk-GGUDZD4K.js";
+} from "../chunk-JU53JE4P.js";
 import "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
-import "../chunk-IF6GI4WU.js";
+import "../chunk-PFX7LHRZ.js";
 import "../chunk-B2Q23JW3.js";
-import "../chunk-PQMKRFBQ.js";
+import "../chunk-PVTUVUBK.js";
+import "../chunk-AJBCHKBP.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-QNC5QRIO.js";
+import "../chunk-QTGT76RY.js";
 import "../chunk-5TD7NQIW.js";
 export {
   buildSite

package/dist/node/node/check.d.ts

@@ -1,3 +1,10 @@
-declare function checkLinks(): Promise<void>;
+interface CheckOptions {
+    frontmatterOnly?: boolean;
+}
+declare function checkFrontmatter(): Promise<{
+    errors: number;
+    warnings: number;
+}>;
+declare function checkLinks(options?: CheckOptions): Promise<void>;
 
-export { checkLinks };
+export { type CheckOptions, checkFrontmatter, checkLinks };

package/dist/node/node/check.js

@@ -1,10 +1,13 @@
 import {
+  checkFrontmatter,
   checkLinks
-} from "../chunk-77VHQV7W.js";
-import "../chunk-PQMKRFBQ.js";
+} from "../chunk-NGWAMBXS.js";
+import "../chunk-PVTUVUBK.js";
+import "../chunk-AJBCHKBP.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-QNC5QRIO.js";
+import "../chunk-QTGT76RY.js";
 import "../chunk-5TD7NQIW.js";
 export {
+  checkFrontmatter,
   checkLinks
 };

package/dist/node/node/index.d.ts

@@ -1,7 +1,7 @@
 import * as vite from 'vite';
 export { buildSite as build } from './build.js';
 export { init } from './init.js';
-export { checkLinks } from './check.js';
+export { checkFrontmatter, checkLinks } from './check.js';
 
 declare function createServer(options?: {
     port?: number;

package/dist/node/node/index.js

@@ -1,26 +1,28 @@
 import {
   buildSite
-} from "../chunk-GGUDZD4K.js";
+} from "../chunk-JU53JE4P.js";
 import {
   remarkMermaidToComponent
 } from "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "../chunk-IF6GI4WU.js";
+} from "../chunk-PFX7LHRZ.js";
 import "../chunk-B2Q23JW3.js";
 import {
   init
-} from "../chunk-QIAMD2Q6.js";
+} from "../chunk-3CW4MOO4.js";
 import {
+  checkFrontmatter,
   checkLinks
-} from "../chunk-77VHQV7W.js";
+} from "../chunk-NGWAMBXS.js";
 import {
   loadUserConfig,
   resolveConfig
-} from "../chunk-PQMKRFBQ.js";
+} from "../chunk-PVTUVUBK.js";
+import "../chunk-AJBCHKBP.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-QNC5QRIO.js";
+import "../chunk-QTGT76RY.js";
 import "../chunk-5TD7NQIW.js";
 
 // src/node/index.ts
@@ -31,8 +33,9 @@ import remarkGfm from "remark-gfm";
 import remarkFrontmatter from "remark-frontmatter";
 import remarkMdxFrontmatter from "remark-mdx-frontmatter";
 import rehypeShiki from "@shikijs/rehype";
-import { resolve } from "path";
+import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
+import { createRequire } from "module";
 import tailwindcss from "@tailwindcss/vite";
 import { existsSync } from "fs";
 function findPackageRoot() {
@@ -49,9 +52,22 @@ function resolveClientPath(...segments) {
   const packageRoot = findPackageRoot();
   return resolve(packageRoot, "src", "client", ...segments);
 }
+function dedupeResolve() {
+  const require2 = createRequire(import.meta.url);
+  const dedupePkgs = ["@mdx-js/react", "react", "react-dom", "react-router-dom"];
+  const alias = {};
+  for (const pkg of dedupePkgs) {
+    try {
+      alias[pkg] = dirname(require2.resolve(`${pkg}/package.json`));
+    } catch {
+    }
+  }
+  return { alias, dedupe: dedupePkgs };
+}
 function createDevConfig(overrides = {}) {
   const root = resolveClientPath();
   const { userRoot, mermaidStrategy, ...viteOverrides } = overrides;
+  const { alias: dedupeAlias, dedupe } = dedupeResolve();
   return {
     root,
     plugins: [
@@ -78,8 +94,10 @@ function createDevConfig(overrides = {}) {
     },
     resolve: {
       alias: {
-        "@clearify": resolve(root, "..")
-      }
+        "@clearify": resolve(root, ".."),
+        ...dedupeAlias
+      },
+      dedupe
     },
     ...viteOverrides
   };
@@ -102,6 +120,7 @@ async function createServer(options = {}) {
 }
 export {
   buildSite as build,
+  checkFrontmatter,
   checkLinks,
   createServer,
   init

package/dist/node/node/init.js

@@ -1,6 +1,6 @@
 import {
   init
-} from "../chunk-QIAMD2Q6.js";
+} from "../chunk-3CW4MOO4.js";
 export {
   init
 };

package/dist/node/types/index.d.ts

@@ -1,3 +1,9 @@
+interface RemoteGitSource {
+    repo: string;
+    ref?: string;
+    path?: string;
+    sparse?: boolean;
+}
 interface SectionConfig {
     label: string;
     docsDir: string;
@@ -5,6 +11,7 @@ interface SectionConfig {
     draft?: boolean;
     sitemap?: boolean;
     exclude?: string[];
+    git?: RemoteGitSource;
 }
 interface ResolvedSection {
     id: string;
@@ -63,11 +70,18 @@ interface NavigationItem {
     badgeColor?: string;
     children?: NavigationItem[];
 }
+type DocCategory = 'documentation' | 'internal' | 'plan' | 'research' | 'decision' | 'roadmap' | 'changelog';
 interface PageFrontmatter {
     title?: string;
     description?: string;
     icon?: string;
     order?: number;
+    summary?: string;
+    category?: DocCategory;
+    tags?: string[];
+    projects?: string[];
+    status?: 'active' | 'superseded' | 'archived';
+    date?: string;
 }
 interface RouteEntry {
     path: string;
@@ -88,11 +102,15 @@ interface HubProject {
     group?: string;
     hubUrl?: string;
     hubName?: string;
+    mode?: 'link' | 'embed';
+    git?: RemoteGitSource;
+    embedSections?: 'all' | 'public' | string[];
 }
 interface HubConfig {
     projects: HubProject[];
     scan?: string;
+    cacheDir?: string;
 }
 declare function defineConfig(config: Partial<ClearifyConfig>): Partial<ClearifyConfig>;
 
-export { type ClearifyConfig, type HubConfig, type HubProject, type NavigationItem, type PageFrontmatter, type ResolvedSection, type RouteEntry, type SectionConfig, type SectionNavigation, defineConfig };
+export { type ClearifyConfig, type DocCategory, type HubConfig, type HubProject, type NavigationItem, type PageFrontmatter, type RemoteGitSource, type ResolvedSection, type RouteEntry, type SectionConfig, type SectionNavigation, defineConfig };

package/dist/node/vite-plugin/index.js

@@ -1,10 +1,11 @@
 import {
   clearifyPlugin
-} from "../chunk-IF6GI4WU.js";
+} from "../chunk-PFX7LHRZ.js";
 import "../chunk-B2Q23JW3.js";
-import "../chunk-PQMKRFBQ.js";
+import "../chunk-PVTUVUBK.js";
+import "../chunk-AJBCHKBP.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-QNC5QRIO.js";
+import "../chunk-QTGT76RY.js";
 import "../chunk-5TD7NQIW.js";
 export {
   clearifyPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marlinjai/clearify",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "An open-source documentation site generator. Turn markdown into beautiful docs.",
   "type": "module",
   "bin": {
@@ -24,7 +24,9 @@
   ],
   "scripts": {
     "build": "tsup",
-    "dev:self": "node bin/clearify.js dev"
+    "dev:self": "node bin/clearify.js dev",
+    "prepare": "husky",
+    "release": "semantic-release"
   },
   "dependencies": {
     "@mdx-js/react": "^3.1.1",
@@ -63,12 +65,18 @@
     }
   },
   "devDependencies": {
+    "@commitlint/cli": "^20.4.3",
+    "@commitlint/config-conventional": "^20.4.3",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/mdast": "^4.0.4",
     "@types/node": "^25.2.2",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
     "esbuild": "^0.27.3",
+    "husky": "^9.1.7",
     "puppeteer": "^24.37.2",
+    "semantic-release": "^25.0.3",
     "tsup": "^8.3.6",
     "typescript": "^5.7.3"
   },