fromsrc 0.0.2 → 0.0.21

package/dist/migrate.js

@@ -20,7 +20,9 @@ function convertAdmonitions(content) {
       result.push('<Callout type="danger">');
     } else if (/^:::\s*$/.test(line) && stack.length > 0) {
       const tag = stack.pop();
-      if (!tag) continue;
+      if (!tag) {
+        continue;
+      }
       result.push(`</${tag}>`);
     } else {
       result.push(line);
@@ -30,45 +32,51 @@ function convertAdmonitions(content) {
 }
 const migrateDocusaurus = (content, _filepath) => {
   let out = content;
-  out = out.replace(/^import\s+.*from\s+['"]@docusaurus\/.*['"];?\s*$/gm, "");
-  out = out.replace(
+  out = out.replaceAll(
+    /^import\s+.*from\s+['"]@docusaurus\/.*['"];?\s*$/gm,
+    ""
+  );
+  out = out.replaceAll(
     /<TabItem\s+value="([^"]*)"(?:\s+label="([^"]*)")?>/g,
     '<Tab value="$1" label="$2">'
   );
-  out = out.replace(/<\/TabItem>/g, "</Tab>");
-  out = out.replace(/<CodeBlock(?:\s+language="([^"]*)")?\s*>/g, "```$1");
-  out = out.replace(/<\/CodeBlock>/g, "```");
+  out = out.replaceAll("</TabItem>", "</Tab>");
+  out = out.replaceAll(/<CodeBlock(?:\s+language="([^"]*)")?\s*>/g, "```$1");
+  out = out.replaceAll("</CodeBlock>", "```");
   out = convertAdmonitions(out);
-  out = out.replace(/^sidebar_position:\s*.*$/gm, "");
-  out = out.replace(/^sidebar_label:\s*.*$/gm, "");
-  out = out.replace(/\n{3,}/g, "\n\n");
+  out = out.replaceAll(/^sidebar_position:\s*.*$/gm, "");
+  out = out.replaceAll(/^sidebar_label:\s*.*$/gm, "");
+  out = out.replaceAll(/\n{3,}/g, "\n\n");
   return `${out.trim()}
 `;
 };
 const migrateNextra = (content, _filepath) => {
   let out = content;
-  out = out.replace(/<Callout\s+type="([^"]*)"(?:\s+emoji="[^"]*")?>/g, '<Callout type="$1">');
-  out = out.replace(/<Tabs\s+items=\{(\[.*?\])\}>/g, "<Tabs items={$1}>");
-  out = out.replace(/<Tabs\.Tab>/g, "<Tab>");
-  out = out.replace(/<\/Tabs\.Tab>/g, "</Tab>");
+  out = out.replaceAll(
+    /<Callout\s+type="([^"]*)"(?:\s+emoji="[^"]*")?>/g,
+    '<Callout type="$1">'
+  );
+  out = out.replaceAll(/<Tabs\s+items=\{(\[.*?\])\}>/g, "<Tabs items={$1}>");
+  out = out.replaceAll("<Tabs.Tab>", "<Tab>");
+  out = out.replaceAll("</Tabs.Tab>", "</Tab>");
   return `${out.trim()}
 `;
 };
 const migrateMintlify = (content, _filepath) => {
   let out = content;
-  out = out.replace(/<CardGroup(?:\s+cols=\{(\d+)\})?>/g, "<Cards>");
-  out = out.replace(/<\/CardGroup>/g, "</Cards>");
-  out = out.replace(/^api:\s*.*$/gm, "");
-  out = out.replace(/^openapi:\s*.*$/gm, "");
-  out = out.replace(/^auth:\s*.*$/gm, "");
-  out = out.replace(/\n{3,}/g, "\n\n");
+  out = out.replaceAll(/<CardGroup(?:\s+cols=\{(\d+)\})?>/g, "<Cards>");
+  out = out.replaceAll("</CardGroup>", "</Cards>");
+  out = out.replaceAll(/^api:\s*.*$/gm, "");
+  out = out.replaceAll(/^openapi:\s*.*$/gm, "");
+  out = out.replaceAll(/^auth:\s*.*$/gm, "");
+  out = out.replaceAll(/\n{3,}/g, "\n\n");
   return `${out.trim()}
 `;
 };
 const transforms = {
   docusaurus: migrateDocusaurus,
-  nextra: migrateNextra,
-  mintlify: migrateMintlify
+  mintlify: migrateMintlify,
+  nextra: migrateNextra
 };
 async function collectFiles(dir) {
   const results = [];
@@ -93,13 +101,15 @@ async function migrate(config) {
     const rel = relative(inputDir, filepath);
     const dest = join(outputDir, rel);
     try {
-      const content = await readFile(filepath, "utf-8");
+      const content = await readFile(filepath, "utf8");
       const result = transform(content, filepath);
       await mkdir(dirname(dest), { recursive: true });
-      await writeFile(dest, result, "utf-8");
+      await writeFile(dest, result, "utf8");
       count++;
-    } catch (err) {
-      warnings.push(`${rel}: ${err instanceof Error ? err.message : String(err)}`);
+    } catch (error) {
+      warnings.push(
+        `${rel}: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   return { files: count, warnings };

package/dist/navgen.d.ts

@@ -1,26 +1,26 @@
-type NavItem = {
+interface NavItem {
     title: string;
     path: string;
     children?: NavItem[];
     order?: number;
     icon?: string;
-};
-type NavConfig = {
+}
+interface NavConfig {
     dir: string;
     extensions?: string[];
     orderFile?: string;
     titleFromFile?: boolean;
-};
-type NavTree = {
+}
+interface NavTree {
     items: NavItem[];
     flat: NavItem[];
-};
-type SidebarItem = {
+}
+interface SidebarItem {
     title: string;
     href: string;
     icon?: string;
     items?: SidebarItem[];
-};
+}
 declare function generateNav(config: NavConfig): Promise<NavTree>;
 declare function sortNav(items: NavItem[]): NavItem[];
 declare function flattenNav(items: NavItem[]): NavItem[];

package/dist/navgen.js

@@ -2,19 +2,27 @@ import { readdir, readFile } from 'node:fs/promises';
 import { join, relative, basename, extname } from 'node:path';
 
 function titleize(s) {
-  return s.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  return s.replaceAll(/[-_]/g, " ").replaceAll(/\b\w/g, (c) => c.toUpperCase());
 }
 function isrecord(value) {
   return typeof value === "object" && value !== null;
 }
 function ismetaentry(value) {
-  if (!isrecord(value)) return false;
-  const title = value.title;
-  const order = value.order;
-  const icon = value.icon;
-  if (title !== void 0 && typeof title !== "string") return false;
-  if (order !== void 0 && typeof order !== "number") return false;
-  if (icon !== void 0 && typeof icon !== "string") return false;
+  if (!isrecord(value)) {
+    return false;
+  }
+  const { title } = value;
+  const { order } = value;
+  const { icon } = value;
+  if (title !== void 0 && typeof title !== "string") {
+    return false;
+  }
+  if (order !== void 0 && typeof order !== "number") {
+    return false;
+  }
+  if (icon !== void 0 && typeof icon !== "string") {
+    return false;
+  }
   return true;
 }
 function parsejson(raw) {
@@ -26,16 +34,20 @@ function parsejson(raw) {
 }
 function parsemetats(raw) {
   const match = raw.match(/export\s+default\s+({[\s\S]*})/);
-  if (!match) return null;
+  if (!match) {
+    return null;
+  }
   const body = match[1];
   return body ? parsejson(body) : null;
 }
 async function readMeta(dir) {
   for (const name of ["_meta.json", "_meta.ts"]) {
     try {
-      const raw = await readFile(join(dir, name), "utf-8");
+      const raw = await readFile(join(dir, name), "utf8");
       const parsed = name.endsWith(".json") ? parsejson(raw) : parsemetats(raw);
-      if (!isrecord(parsed)) return {};
+      if (!isrecord(parsed)) {
+        return {};
+      }
       const result = {};
       for (const [key, value] of Object.entries(parsed)) {
         if (typeof value === "string" || ismetaentry(value)) {
@@ -50,7 +62,7 @@ async function readMeta(dir) {
 }
 async function extractTitle(file) {
   try {
-    const m = (await readFile(file, "utf-8")).match(/^#\s+(.+)$/m);
+    const m = (await readFile(file, "utf8")).match(/^#\s+(.+)$/m);
     const title = m?.[1];
     return title ? title.trim() : null;
   } catch {
@@ -62,34 +74,48 @@ function resolveMeta(meta, key, fallback) {
   const title = typeof e === "string" ? e : e?.title ?? fallback;
   const order = typeof e === "string" ? void 0 : e?.order;
   const icon = typeof e === "string" ? void 0 : e?.icon;
-  return { title, order, icon };
+  return { icon, order, title };
 }
 async function scanDir(dir, root, exts, h1) {
   const entries = await readdir(dir, { withFileTypes: true });
   const meta = await readMeta(dir);
   const items = [];
   for (const entry of entries) {
-    if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
+    if (entry.name.startsWith("_") || entry.name.startsWith(".")) {
+      continue;
+    }
     const full = join(dir, entry.name);
-    const rel = relative(root, full).replace(/\\/g, "/");
+    const rel = relative(root, full).replaceAll("\\", "/");
     if (entry.isDirectory()) {
       const children = await scanDir(full, root, exts, h1);
       const idx = children.find((c) => basename(c.path).startsWith("index"));
-      const r2 = resolveMeta(meta, entry.name, idx?.title ?? titleize(entry.name));
+      const r2 = resolveMeta(
+        meta,
+        entry.name,
+        idx?.title ?? titleize(entry.name)
+      );
       items.push({
         ...r2,
-        path: "/" + rel,
-        children: children.filter((c) => !basename(c.path).startsWith("index"))
+        children: children.filter((c) => !basename(c.path).startsWith("index")),
+        path: "/" + rel
       });
       continue;
     }
     const ext = extname(entry.name);
-    if (!exts.includes(ext)) continue;
+    if (!exts.includes(ext)) {
+      continue;
+    }
     const slug = rel.replace(new RegExp(`${ext}$`), "");
-    const r = resolveMeta(meta, basename(entry.name, ext), titleize(basename(entry.name, ext)));
+    const r = resolveMeta(
+      meta,
+      basename(entry.name, ext),
+      titleize(basename(entry.name, ext))
+    );
     if (h1) {
       const t = await extractTitle(full);
-      if (t) r.title = t;
+      if (t) {
+        r.title = t;
+      }
     }
     items.push({ ...r, path: "/" + slug });
   }
@@ -97,35 +123,48 @@ async function scanDir(dir, root, exts, h1) {
 }
 async function generateNav(config) {
   const exts = config.extensions ?? [".mdx", ".md"];
-  const items = await scanDir(config.dir, config.dir, exts, config.titleFromFile ?? false);
-  return { items, flat: flattenNav(items) };
+  const items = await scanDir(
+    config.dir,
+    config.dir,
+    exts,
+    config.titleFromFile ?? false
+  );
+  return { flat: flattenNav(items), items };
 }
 function sortNav(items) {
-  return [...items].sort((a, b) => (a.order ?? 999) - (b.order ?? 999) || a.title.localeCompare(b.title)).map((i) => i.children ? { ...i, children: sortNav(i.children) } : i);
+  return [...items].sort(
+    (a, b) => (a.order ?? 999) - (b.order ?? 999) || a.title.localeCompare(b.title)
+  ).map((i) => i.children ? { ...i, children: sortNav(i.children) } : i);
 }
 function flattenNav(items) {
   const r = [];
   for (const i of items) {
     r.push(i);
-    if (i.children) r.push(...flattenNav(i.children));
+    if (i.children) {
+      r.push(...flattenNav(i.children));
+    }
   }
   return r;
 }
 function findNavItem(items, path) {
   for (const i of items) {
-    if (i.path === path) return i;
+    if (i.path === path) {
+      return i;
+    }
     if (i.children) {
       const f = findNavItem(i.children, path);
-      if (f) return f;
+      if (f) {
+        return f;
+      }
     }
   }
   return void 0;
 }
 function navToSidebar(items) {
   return items.map((i) => ({
-    title: i.title,
     href: i.path,
     icon: i.icon,
+    title: i.title,
     ...i.children?.length ? { items: navToSidebar(i.children) } : {}
   }));
 }
@@ -133,10 +172,14 @@ function breadcrumbFromPath(items, path) {
   function walk(cur, trail) {
     for (const i of cur) {
       const next = [...trail, i];
-      if (i.path === path) return next;
+      if (i.path === path) {
+        return next;
+      }
       if (i.children) {
         const f = walk(i.children, next);
-        if (f) return f;
+        if (f) {
+          return f;
+        }
       }
     }
     return null;

package/dist/navtree.d.ts

@@ -21,8 +21,8 @@ declare function flattenNavTree(nodes: NavNode[]): NavNode[];
 declare function findNavNode(nodes: NavNode[], slug: string): NavNode | null;
 declare function getNavBreadcrumbs(nodes: NavNode[], slug: string): NavNode[];
 declare function getPrevNext(nodes: NavNode[], slug: string): {
-    prev: NavNode | null;
     next: NavNode | null;
+    prev: NavNode | null;
 };
 
 export { type NavNode, type NavTreeConfig, buildNavTree, findNavNode, flattenNavTree, getNavBreadcrumbs, getPrevNext };

package/dist/navtree.js

@@ -1,20 +1,22 @@
 function titleize(s) {
-  return s.charAt(0).toUpperCase() + s.slice(1).replace(/-/g, " ");
+  return s.charAt(0).toUpperCase() + s.slice(1).replaceAll("-", " ");
 }
 function buildNavTree(config) {
   const { docs, basePath = "/docs" } = config;
   const root = [];
   const map = /* @__PURE__ */ new Map();
-  const sorted = [...docs].sort((a, b) => (a.order ?? 99) - (b.order ?? 99));
+  const sorted = [...docs].sort(
+    (a, b) => (a.order ?? 99) - (b.order ?? 99)
+  );
   for (const doc of sorted) {
     const segments = doc.slug.split("/").filter(Boolean);
     if (segments.length === 0) {
       const node = {
-        title: doc.title,
-        slug: doc.slug,
-        href: basePath,
         children: [],
-        order: doc.order
+        href: basePath,
+        order: doc.order,
+        slug: doc.slug,
+        title: doc.title
       };
       map.set("", node);
       root.push(node);
@@ -24,17 +26,19 @@ function buildNavTree(config) {
     let path = "";
     for (let i = 0; i < segments.length; i++) {
       const segment = segments[i];
-      if (!segment) continue;
+      if (!segment) {
+        continue;
+      }
       path = path ? `${path}/${segment}` : segment;
       const isLast = i === segments.length - 1;
       let existing = map.get(path);
       if (!existing) {
         existing = {
-          title: isLast ? doc.title : titleize(segment),
-          slug: path,
-          href: isLast ? `${basePath}/${path}` : void 0,
           children: [],
-          order: isLast ? doc.order : void 0
+          href: isLast ? `${basePath}/${path}` : void 0,
+          order: isLast ? doc.order : void 0,
+          slug: path,
+          title: isLast ? doc.title : titleize(segment)
         };
         map.set(path, existing);
         parentChildren.push(existing);
@@ -48,7 +52,11 @@ function buildNavTree(config) {
   }
   function sortNodes(nodes) {
     nodes.sort((a, b) => (a.order ?? 99) - (b.order ?? 99));
-    for (const node of nodes) if (node.children.length > 0) sortNodes(node.children);
+    for (const node of nodes) {
+      if (node.children.length > 0) {
+        sortNodes(node.children);
+      }
+    }
   }
   sortNodes(root);
   return root;
@@ -57,15 +65,21 @@ function flattenNavTree(nodes) {
   const result = [];
   for (const node of nodes) {
     result.push(node);
-    if (node.children.length > 0) result.push(...flattenNavTree(node.children));
+    if (node.children.length > 0) {
+      result.push(...flattenNavTree(node.children));
+    }
   }
   return result;
 }
 function findNavNode(nodes, slug) {
   for (const node of nodes) {
-    if (node.slug === slug) return node;
+    if (node.slug === slug) {
+      return node;
+    }
     const found = findNavNode(node.children, slug);
-    if (found) return found;
+    if (found) {
+      return found;
+    }
   }
   return null;
 }
@@ -73,9 +87,13 @@ function getNavBreadcrumbs(nodes, slug) {
   function walk(current, path) {
     for (const node of current) {
       const next = [...path, node];
-      if (node.slug === slug) return next;
+      if (node.slug === slug) {
+        return next;
+      }
       const found = walk(node.children, next);
-      if (found) return found;
+      if (found) {
+        return found;
+      }
     }
     return null;
   }
@@ -84,10 +102,12 @@ function getNavBreadcrumbs(nodes, slug) {
 function getPrevNext(nodes, slug) {
   const flat = flattenNavTree(nodes).filter((n) => n.href);
   const i = flat.findIndex((n) => n.slug === slug);
-  if (i === -1) return { prev: null, next: null };
+  if (i === -1) {
+    return { next: null, prev: null };
+  }
   const prev = i > 0 ? flat[i - 1] ?? null : null;
   const next = i < flat.length - 1 ? flat[i + 1] ?? null : null;
-  return { prev, next };
+  return { next, prev };
 }
 
 export { buildNavTree, findNavNode, flattenNavTree, getNavBreadcrumbs, getPrevNext };

package/dist/oembed.d.ts

@@ -1,4 +1,4 @@
-type OembedData = {
+interface OembedData {
     type: "video" | "rich" | "photo" | "link";
     title?: string;
     html?: string;
@@ -6,12 +6,12 @@ type OembedData = {
     height?: number;
     thumbnail?: string;
     provider?: string;
-};
-type OembedProvider = {
+}
+interface OembedProvider {
     name: string;
     pattern: RegExp;
     endpoint: string;
-};
+}
 declare const providers: OembedProvider[];
 declare function resolve(url: string): Promise<OembedData | null>;
 declare function resolveMany(urls: string[]): Promise<Map<string, OembedData | null>>;

package/dist/oembed.js

@@ -1,28 +1,28 @@
 const providers = [
   {
+    endpoint: "https://www.youtube.com/oembed",
     name: "YouTube",
-    pattern: /(?:youtube\.com\/watch|youtu\.be\/)/,
-    endpoint: "https://www.youtube.com/oembed"
+    pattern: /(?:youtube\.com\/watch|youtu\.be\/)/
   },
   {
+    endpoint: "https://vimeo.com/api/oembed.json",
     name: "Vimeo",
-    pattern: /vimeo\.com\//,
-    endpoint: "https://vimeo.com/api/oembed.json"
+    pattern: /vimeo\.com\//
   },
   {
+    endpoint: "https://publish.twitter.com/oembed",
     name: "Twitter",
-    pattern: /(?:twitter\.com|x\.com)\//,
-    endpoint: "https://publish.twitter.com/oembed"
+    pattern: /(?:twitter\.com|x\.com)\//
   },
   {
+    endpoint: "https://codepen.io/api/oembed",
     name: "CodePen",
-    pattern: /codepen\.io\//,
-    endpoint: "https://codepen.io/api/oembed"
+    pattern: /codepen\.io\//
   },
   {
+    endpoint: "https://codesandbox.io/oembed",
     name: "CodeSandbox",
-    pattern: /codesandbox\.io\//,
-    endpoint: "https://codesandbox.io/oembed"
+    pattern: /codesandbox\.io\//
   }
 ];
 function find(url) {
@@ -30,27 +30,33 @@ function find(url) {
 }
 async function resolve(url) {
   const provider = find(url);
-  if (!provider) return null;
+  if (!provider) {
+    return null;
+  }
   try {
     const endpoint = `${provider.endpoint}?url=${encodeURIComponent(url)}&format=json`;
     const response = await fetch(endpoint);
-    if (!response.ok) return null;
+    if (!response.ok) {
+      return null;
+    }
     const data = await response.json();
     return {
-      type: data.type ?? "link",
-      title: data.title,
-      html: data.html,
-      width: data.width,
       height: data.height,
+      html: data.html,
+      provider: provider.name,
       thumbnail: data.thumbnail_url,
-      provider: provider.name
+      title: data.title,
+      type: data.type ?? "link",
+      width: data.width
     };
   } catch {
     return null;
   }
 }
 async function resolveMany(urls) {
-  const entries = await Promise.all(urls.map(async (url) => [url, await resolve(url)]));
+  const entries = await Promise.all(
+    urls.map(async (url) => [url, await resolve(url)])
+  );
   return new Map(entries);
 }
 const urlPattern = /https?:\/\/[^\s)>\]]+/g;

package/dist/ogimage.d.ts

@@ -1,4 +1,4 @@
-type OgImageConfig = {
+interface OgImageConfig {
     title: string;
     description?: string;
     siteName?: string;
@@ -7,29 +7,29 @@ type OgImageConfig = {
     accentColor?: string;
     width?: number;
     height?: number;
-};
-type OgImageMeta = {
+}
+interface OgImageMeta {
     url: string;
     width: number;
     height: number;
     alt: string;
     type: string;
-};
+}
 declare function ogImageUrl(base: string, params: Record<string, string | undefined>): string;
 declare function generateOgMeta(base: string, config: OgImageConfig): OgImageMeta;
 declare function defaultTemplate(config: OgImageConfig): {
-    title: string;
-    description: string;
-    siteName: string;
-    logo: string;
-    width: number;
-    height: number;
     colors: {
+        accent: string;
         background: string;
         foreground: string;
         muted: string;
-        accent: string;
     };
+    description: string;
+    height: number;
+    logo: string;
+    siteName: string;
+    title: string;
+    width: number;
 };
 type MetaTag = {
     property: string;