fromsrc 0.0.2 → 0.0.21

package/dist/config.js

@@ -2,18 +2,18 @@ import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 
 const defaults = {
-  description: "",
   baseUrl: "/",
+  description: "",
   docsDir: "docs",
-  outDir: ".fromsrc",
-  theme: "default",
-  search: { provider: "local", options: {} },
-  sidebar: { defaultOpen: true, collapsible: true },
-  toc: { minDepth: 2, maxDepth: 3 },
-  i18n: { defaultLocale: "en", locales: ["en"] },
+  draft: false,
   editUrl: "",
+  i18n: { defaultLocale: "en", locales: ["en"] },
   lastUpdated: false,
-  draft: false
+  outDir: ".fromsrc",
+  search: { options: {}, provider: "local" },
+  sidebar: { collapsible: true, defaultOpen: true },
+  theme: "default",
+  toc: { maxDepth: 3, minDepth: 2 }
 };
 function isrecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -25,32 +25,52 @@ function isboolean(value) {
   return typeof value === "boolean";
 }
 function parseconfig(value) {
-  if (!isrecord(value)) return null;
-  const title = value.title;
-  if (!isstring(title)) return null;
+  if (!isrecord(value)) {
+    return null;
+  }
+  const { title } = value;
+  if (!isstring(title)) {
+    return null;
+  }
   const config = { title };
-  if (isstring(value.description)) config.description = value.description;
-  if (isstring(value.baseUrl)) config.baseUrl = value.baseUrl;
-  if (isstring(value.docsDir)) config.docsDir = value.docsDir;
-  if (isstring(value.outDir)) config.outDir = value.outDir;
-  if (isstring(value.theme)) config.theme = value.theme;
-  if (isstring(value.editUrl)) config.editUrl = value.editUrl;
-  if (isboolean(value.lastUpdated)) config.lastUpdated = value.lastUpdated;
-  if (isboolean(value.draft)) config.draft = value.draft;
+  if (isstring(value.description)) {
+    config.description = value.description;
+  }
+  if (isstring(value.baseUrl)) {
+    config.baseUrl = value.baseUrl;
+  }
+  if (isstring(value.docsDir)) {
+    config.docsDir = value.docsDir;
+  }
+  if (isstring(value.outDir)) {
+    config.outDir = value.outDir;
+  }
+  if (isstring(value.theme)) {
+    config.theme = value.theme;
+  }
+  if (isstring(value.editUrl)) {
+    config.editUrl = value.editUrl;
+  }
+  if (isboolean(value.lastUpdated)) {
+    config.lastUpdated = value.lastUpdated;
+  }
+  if (isboolean(value.draft)) {
+    config.draft = value.draft;
+  }
   if (isrecord(value.search)) {
     const provider = isstring(value.search.provider) ? value.search.provider : void 0;
     const options = isrecord(value.search.options) ? value.search.options : void 0;
-    config.search = { provider, options };
+    config.search = { options, provider };
   }
   if (isrecord(value.sidebar)) {
     const defaultOpen = isboolean(value.sidebar.defaultOpen) ? value.sidebar.defaultOpen : void 0;
     const collapsible = isboolean(value.sidebar.collapsible) ? value.sidebar.collapsible : void 0;
-    config.sidebar = { defaultOpen, collapsible };
+    config.sidebar = { collapsible, defaultOpen };
   }
   if (isrecord(value.toc)) {
     const minDepth = typeof value.toc.minDepth === "number" ? value.toc.minDepth : void 0;
     const maxDepth = typeof value.toc.maxDepth === "number" ? value.toc.maxDepth : void 0;
-    config.toc = { minDepth, maxDepth };
+    config.toc = { maxDepth, minDepth };
   }
   if (isrecord(value.i18n)) {
     const defaultLocale = isstring(value.i18n.defaultLocale) ? value.i18n.defaultLocale : void 0;
@@ -63,24 +83,27 @@ function defineConfig(config) {
   return config;
 }
 function resolveConfig(config) {
-  return mergeConfig(
-    defaults,
-    config
-  );
+  const base = { ...defaults };
+  const over = { ...config };
+  return mergeConfig(base, over);
 }
 async function loadConfig(dir) {
   for (const name of ["fromsrc.config.ts", "fromsrc.config.js"]) {
     try {
       const mod = await import(/* webpackIgnore: true */ join(dir, name));
       const parsed = parseconfig(mod.default ?? mod);
-      if (parsed) return parsed;
+      if (parsed) {
+        return parsed;
+      }
     } catch {
     }
   }
   try {
-    const raw = await readFile(join(dir, "fromsrc.config.json"), "utf-8");
+    const raw = await readFile(join(dir, "fromsrc.config.json"), "utf8");
     const parsed = parseconfig(JSON.parse(raw));
-    if (parsed) return parsed;
+    if (parsed) {
+      return parsed;
+    }
   } catch {
   }
   throw new Error("no config found");
@@ -91,7 +114,10 @@ function mergeConfig(base, overrides) {
     const b = base[key];
     const o = overrides[key];
     if (b && o && typeof b === "object" && typeof o === "object" && !Array.isArray(o)) {
-      result[key] = mergeConfig(b, o);
+      result[key] = mergeConfig(
+        b,
+        o
+      );
     } else if (o !== void 0) {
       result[key] = o;
     }

package/dist/content.d.ts

@@ -26,6 +26,9 @@ interface ContentConfig<T extends SchemaType = typeof baseSchema> {
     schema?: T;
 }
 declare function defineContent<T extends SchemaType>(config: ContentConfig<T>): {
+    getAllDocs: () => Promise<(z.TypeOf<T> & {
+        slug: string;
+    })[]>;
     getDoc: (slug: string[]) => Promise<(z.TypeOf<T> & {
         slug: string;
     } & {
@@ -38,9 +41,6 @@ declare function defineContent<T extends SchemaType>(config: ContentConfig<T>):
         content: string;
         data: z.infer<T>;
     })[]>;
-    getAllDocs: () => Promise<(z.TypeOf<T> & {
-        slug: string;
-    })[]>;
     getNavigation: () => Promise<{
         title: string;
         items: (z.TypeOf<T> & {
@@ -54,10 +54,10 @@ declare function defineContent<T extends SchemaType>(config: ContentConfig<T>):
         headings?: Heading[];
     })[]>;
     schema: z.ZodObject<{
-        title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
-        order: z.ZodOptional<z.ZodNumber>;
         draft: z.ZodOptional<z.ZodBoolean>;
+        order: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         title: string;
         order?: number | undefined;

package/dist/content.js

@@ -14,11 +14,13 @@ function isnotfound(error) {
 }
 async function readCached(filepath) {
   if (!isProduction()) {
-    return readFile(filepath, "utf-8");
+    return readFile(filepath, "utf8");
   }
   const cached = fileCache.get(filepath);
-  if (cached) return cached;
-  const content = await readFile(filepath, "utf-8");
+  if (cached) {
+    return cached;
+  }
+  const content = await readFile(filepath, "utf8");
   fileCache.set(filepath, content);
   return content;
 }
@@ -28,15 +30,19 @@ async function resolveSource(docsDir, slug) {
   const indexPath = join(docsDir, `${path}/index.mdx`);
   try {
     const source = await readCached(filepath);
-    return { source, actualPath: path, filepath };
+    return { actualPath: path, filepath, source };
   } catch (error) {
-    if (!isnotfound(error)) throw error;
+    if (!isnotfound(error)) {
+      throw error;
+    }
   }
   try {
     const source = await readCached(indexPath);
-    return { source, actualPath: `${path}/index`, filepath: indexPath };
+    return { actualPath: `${path}/index`, filepath: indexPath, source };
   } catch (error) {
-    if (!isnotfound(error)) throw error;
+    if (!isnotfound(error)) {
+      throw error;
+    }
   }
   return null;
 }
@@ -51,11 +57,15 @@ function defineContent(config) {
   }
   async function getDoc2(slug) {
     const resolved = await resolveSource(config.dir, slug);
-    if (!resolved) return null;
+    if (!resolved) {
+      return null;
+    }
     try {
       const { data, content } = matter(resolved.source);
       const parsed = schema.parse(data);
-      if (isProduction() && isDraft(data)) return null;
+      if (isProduction() && isDraft(data)) {
+        return null;
+      }
       return {
         slug: resolved.actualPath,
         ...parsed,
@@ -73,7 +83,9 @@ function defineContent(config) {
     }
   }
   async function getAllDocs2() {
-    if (isProduction() && docsCache) return docsCache;
+    if (isProduction() && docsCache) {
+      return docsCache;
+    }
     if (isProduction() && fullDocsCache) {
       const sorted2 = fullDocsCache.map(asMeta);
       docsCache = sorted2;
@@ -90,7 +102,9 @@ function defineContent(config) {
           const source = await readCached(filepath);
           const { data } = matter(source);
           const parsed = schema.parse(data);
-          if (isProduction() && isDraft(data)) continue;
+          if (isProduction() && isDraft(data)) {
+            continue;
+          }
           const slug = `${prefix}${entry.name.replace(".mdx", "")}`;
           docs.push({
             slug: slug === "index" ? "" : slug,
@@ -115,7 +129,9 @@ function defineContent(config) {
     return sorted;
   }
   async function getDocs() {
-    if (isProduction() && fullDocsCache) return fullDocsCache;
+    if (isProduction() && fullDocsCache) {
+      return fullDocsCache;
+    }
     const docs = [];
     async function scan(dir, prefix = "") {
       const entries = await readdir(dir, { withFileTypes: true });
@@ -127,7 +143,9 @@ function defineContent(config) {
           const source = await readCached(filepath);
           const { data, content } = matter(source);
           const parsed = schema.parse(data);
-          if (isProduction() && isDraft(data)) continue;
+          if (isProduction() && isDraft(data)) {
+            continue;
+          }
           const slug = `${prefix}${entry.name.replace(".mdx", "")}`;
           docs.push({
             slug: slug === "index" ? "" : slug,
@@ -154,7 +172,9 @@ function defineContent(config) {
     return sorted;
   }
   async function getNavigation2() {
-    if (isProduction() && navCache) return navCache;
+    if (isProduction() && navCache) {
+      return navCache;
+    }
     try {
       const docs = await getAllDocs2();
       const filtered = await buildNavigation(docs, config.dir);
@@ -169,7 +189,9 @@ function defineContent(config) {
   }
   let searchCache2 = null;
   async function getSearchDocs2() {
-    if (isProduction() && searchCache2) return searchCache2;
+    if (isProduction() && searchCache2) {
+      return searchCache2;
+    }
     if (isProduction() && fullDocsCache) {
       const sorted2 = fullDocsCache.map((doc) => {
         const headings = extractHeadings(doc.content);
@@ -193,7 +215,9 @@ function defineContent(config) {
           const source = await readCached(filepath);
           const { data, content } = matter(source);
           const parsed = schema.parse(data);
-          if (isProduction() && isDraft(data)) continue;
+          if (isProduction() && isDraft(data)) {
+            continue;
+          }
           const slug = `${prefix}${entry.name.replace(".mdx", "")}`;
           const headings = extractHeadings(content);
           docs.push({
@@ -221,19 +245,19 @@ function defineContent(config) {
     return sorted;
   }
   return {
+    getAllDocs: getAllDocs2,
     getDoc: getDoc2,
     getDocs,
-    getAllDocs: getAllDocs2,
     getNavigation: getNavigation2,
     getSearchDocs: getSearchDocs2,
     schema
   };
 }
 function stripHeadingFormatting(text) {
-  return text.replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/`([^`]+)`/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").trim();
+  return text.replaceAll(/\*\*([^*]+)\*\*/g, "$1").replaceAll(/\*([^*]+)\*/g, "$1").replaceAll(/`([^`]+)`/g, "$1").replaceAll(/\[([^\]]+)\]\([^)]+\)/g, "$1").trim();
 }
 function headingId(text) {
-  return text.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9_-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return text.toLowerCase().replaceAll(/\s+/g, "-").replaceAll(/[^a-z0-9_-]/g, "").replaceAll(/-+/g, "-").replaceAll(/^-|-$/g, "");
 }
 function extractHeadings(content) {
   const headings = [];
@@ -241,38 +265,48 @@ function extractHeadings(content) {
   const lines = content.split("\n");
   for (const line of lines) {
     const match = line.match(/^(#{2,4})\s+(.+)$/);
-    if (!match) continue;
+    if (!match) {
+      continue;
+    }
     const hashes = match[1];
     const heading = match[2];
-    if (!hashes || !heading) continue;
+    if (!hashes || !heading) {
+      continue;
+    }
     const level = hashes.length;
     const raw = stripHeadingFormatting(heading);
     const base = headingId(raw);
-    if (!base) continue;
+    if (!base) {
+      continue;
+    }
     const count = seen.get(base) ?? 0;
     seen.set(base, count + 1);
     const id = count === 0 ? base : `${base}-${count}`;
-    headings.push({ id, text: raw, level });
+    headings.push({ id, level, text: raw });
   }
   return headings;
 }
 function stripMdx(content) {
-  return content.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/import\s+.*?from\s+['"][^'"]+['"];?/g, "").replace(/export\s+.*?;/g, "").replace(/<[^>]+>/g, " ").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/#{1,6}\s+/g, "").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/\n+/g, " ").replace(/\s+/g, " ").trim();
+  return content.replaceAll(/```[\s\S]*?```/g, "").replaceAll(/`[^`]+`/g, "").replaceAll(/import\s+.*?from\s+['"][^'"]+['"];?/g, "").replaceAll(/export\s+.*?;/g, "").replaceAll(/<[^>]+>/g, " ").replaceAll(/\[([^\]]+)\]\([^)]+\)/g, "$1").replaceAll(/#{1,6}\s+/g, "").replaceAll(/\*\*([^*]+)\*\*/g, "$1").replaceAll(/\*([^*]+)\*/g, "$1").replaceAll(/\n+/g, " ").replaceAll(/\s+/g, " ").trim();
 }
 async function getDoc(docsDir, slug) {
   const resolved = await resolveSource(docsDir, slug);
-  if (!resolved) return null;
+  if (!resolved) {
+    return null;
+  }
   try {
     const { data, content } = matter(resolved.source);
     const parsed = baseSchema.parse(data);
-    if (isProduction() && isDraft(data)) return null;
+    if (isProduction() && isDraft(data)) {
+      return null;
+    }
     return {
-      slug: resolved.actualPath,
-      title: parsed.title,
+      content,
+      data: parsed,
       description: parsed.description,
       order: parsed.order,
-      content,
-      data: parsed
+      slug: resolved.actualPath,
+      title: parsed.title
     };
   } catch (error) {
     if (error instanceof z.ZodError) {
@@ -288,7 +322,9 @@ async function getAllDocs(docsDir) {
   const cacheKey = docsDir;
   if (isProduction()) {
     const cached = metaCache.get(cacheKey);
-    if (cached) return cached;
+    if (cached) {
+      return cached;
+    }
   }
   const docs = [];
   const folderMetas = /* @__PURE__ */ new Map();
@@ -304,13 +340,15 @@ async function getAllDocs(docsDir) {
         const source = await readCached(filepath);
         const { data } = matter(source);
         const parsed = baseSchema.parse(data);
-        if (isProduction() && isDraft(data)) continue;
+        if (isProduction() && isDraft(data)) {
+          continue;
+        }
         const slug = `${prefix}${entry.name.replace(".mdx", "")}`;
         docs.push({
-          slug: slug === "index" ? "" : slug,
-          title: parsed.title,
           description: parsed.description,
-          order: parsed.order
+          order: parsed.order,
+          slug: slug === "index" ? "" : slug,
+          title: parsed.title
         });
       }
     }
@@ -350,7 +388,9 @@ async function getSearchDocs(docsDir) {
   const cacheKey = docsDir;
   if (isProduction()) {
     const cached = searchCache.get(cacheKey);
-    if (cached) return cached;
+    if (cached) {
+      return cached;
+    }
   }
   const docs = [];
   async function scan(dir, prefix = "") {
@@ -363,16 +403,18 @@ async function getSearchDocs(docsDir) {
         const source = await readCached(filepath);
         const { data, content } = matter(source);
         const parsed = baseSchema.parse(data);
-        if (isProduction() && isDraft(data)) continue;
+        if (isProduction() && isDraft(data)) {
+          continue;
+        }
         const slug = `${prefix}${entry.name.replace(".mdx", "")}`;
         const headings = extractHeadings(content);
         docs.push({
-          slug: slug === "index" ? "" : slug,
-          title: parsed.title,
+          content: stripMdx(content),
           description: parsed.description,
+          headings: headings.length > 0 ? headings : void 0,
           order: parsed.order,
-          content: stripMdx(content),
-          headings: headings.length > 0 ? headings : void 0
+          slug: slug === "index" ? "" : slug,
+          title: parsed.title
         });
       }
     }
@@ -393,17 +435,19 @@ async function getSearchDocs(docsDir) {
   return sorted;
 }
 function fallbacktitle(key) {
-  if (key === "") return "docs";
-  return key.replace(/-/g, " ");
+  if (key === "") {
+    return "docs";
+  }
+  return key.replaceAll("-", " ");
 }
 async function buildNavigation(docs, docsDir) {
   const grouped = /* @__PURE__ */ new Map();
   for (const doc of docs) {
     const key = groupkey(doc.slug);
     const section = grouped.get(key) ?? {
+      items: [],
       key,
-      title: fallbacktitle(key),
-      items: []
+      title: fallbacktitle(key)
     };
     section.items.push(doc);
     grouped.set(key, section);
@@ -414,16 +458,28 @@ async function buildNavigation(docs, docsDir) {
   sections.sort((left, right) => {
     const leftOrder = order.get(left.key);
     const rightOrder = order.get(right.key);
-    if (leftOrder !== void 0 && rightOrder !== void 0) return leftOrder - rightOrder;
-    if (leftOrder !== void 0) return -1;
-    if (rightOrder !== void 0) return 1;
-    if (left.key === "") return -1;
-    if (right.key === "") return 1;
+    if (leftOrder !== void 0 && rightOrder !== void 0) {
+      return leftOrder - rightOrder;
+    }
+    if (leftOrder !== void 0) {
+      return -1;
+    }
+    if (rightOrder !== void 0) {
+      return 1;
+    }
+    if (left.key === "") {
+      return -1;
+    }
+    if (right.key === "") {
+      return 1;
+    }
     return left.key.localeCompare(right.key);
   });
   const metas = await Promise.all(
     sections.map((section) => {
-      if (section.key === "") return Promise.resolve(rootMeta);
+      if (section.key === "") {
+        return Promise.resolve(rootMeta);
+      }
       return loadMeta(join(docsDir, section.key));
     })
   );
@@ -432,14 +488,16 @@ async function buildNavigation(docs, docsDir) {
     const sorted = sortByMeta(section.items, metas[index]?.pages, prefix);
     const label = metas[index]?.title ?? section.title;
     return {
-      title: label,
-      items: sorted
+      items: sorted,
+      title: label
     };
   }).filter((section) => section.items.length > 0);
 }
 function sectionOrder(pages) {
   const order = /* @__PURE__ */ new Map();
-  if (!pages) return order;
+  if (!pages) {
+    return order;
+  }
   for (const page of pages) {
     const key = groupkey(page);
     if (!order.has(key)) {
@@ -449,10 +507,16 @@ function sectionOrder(pages) {
   return order;
 }
 function groupkey(slug) {
-  if (!slug || slug === "index") return "";
-  if (!slug.includes("/")) return slug;
+  if (!slug || slug === "index") {
+    return "";
+  }
+  if (!slug.includes("/")) {
+    return slug;
+  }
   const [head] = slug.split("/");
-  if (!head || head === "index") return "";
+  if (!head || head === "index") {
+    return "";
+  }
   return head;
 }
 function clearContentCache() {

package/dist/contentcache.d.ts

@@ -1,28 +1,28 @@
-type CacheEntry<T> = {
+interface CacheEntry<T> {
     value: T;
     expires: number;
     key: string;
-};
-type CacheConfig = {
+}
+interface CacheConfig {
     maxSize?: number;
     ttl?: number;
     onEvict?: (key: string) => void;
-};
-type CacheStats = {
+}
+interface CacheStats {
     hits: number;
     misses: number;
     size: number;
     evictions: number;
-};
+}
 declare function createCache<T>(config?: CacheConfig): {
+    clear: () => void;
+    delete: (key: string) => boolean;
     get: (key: string) => T | undefined;
-    set: (key: string, value: T, ttl?: number) => void;
     has: (key: string) => boolean;
-    delete: (key: string) => boolean;
-    clear: () => void;
-    stats: () => CacheStats;
     keys: () => string[];
     prune: () => number;
+    set: (key: string, value: T, ttl?: number) => void;
+    stats: () => CacheStats;
 };
 
 export { type CacheConfig, type CacheEntry, type CacheStats, createCache };

package/dist/contentcache.js

@@ -11,7 +11,9 @@ function createCache(config) {
   }
   function evictOldest() {
     const oldest = store.keys().next().value;
-    if (!oldest) return;
+    if (!oldest) {
+      return;
+    }
     store.delete(oldest);
     evictions++;
     onEvict?.(oldest);
@@ -37,11 +39,13 @@ function createCache(config) {
     if (store.size >= maxSize) {
       evictOldest();
     }
-    store.set(key, { value, expires: Date.now() + (ttl ?? defaultTtl), key });
+    store.set(key, { expires: Date.now() + (ttl ?? defaultTtl), key, value });
   }
   function has(key) {
     const entry = store.get(key);
-    if (!entry) return false;
+    if (!entry) {
+      return false;
+    }
     if (isExpired(entry)) {
       store.delete(key);
       return false;
@@ -55,7 +59,7 @@ function createCache(config) {
     store.clear();
   }
   function stats() {
-    return { hits, misses, size: store.size, evictions };
+    return { evictions, hits, misses, size: store.size };
   }
   function keys() {
     return [...store.keys()];
@@ -70,7 +74,7 @@ function createCache(config) {
     }
     return count;
   }
-  return { get, set, has, delete: del, clear, stats, keys, prune };
+  return { clear, delete: del, get, has, keys, prune, set, stats };
 }
 
 export { createCache };

package/dist/contentdiff.d.ts

@@ -1,14 +1,14 @@
-type ContentChange = {
+interface ContentChange {
     type: "added" | "removed" | "modified";
     path: string;
     title?: string;
-};
-type ContentDiff = {
+}
+interface ContentDiff {
     added: ContentChange[];
     removed: ContentChange[];
     modified: ContentChange[];
     summary: string;
-};
+}
 declare function contentFromDocs(docs: {
     slug: string;
     content: string;