docus 1.0.7 → 2.1.0

package/dist/runtime/navigation.js

@@ -0,0 +1,176 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.generateNavigation = generateNavigation;
+
+var _scule = require("scule");
+
+var _ufo = require("ufo");
+
+var _defu = _interopRequireDefault(require("defu"));
+
+var _object = require("./utils/object");
+
+var _context = require("./context");
+
+var _utils = require("./transformers/utils");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const isIndex = path => path.endsWith("index.md");
+
+function sortItems(keys) {
+  return [...keys].sort((a, b) => a.id.localeCompare(b.id)).sort((a, b) => {
+    const isA = isIndex(a.id);
+    const isB = isIndex(b.id);
+    if (isA && isB) return a.id.length - b.id.length;
+    if (isB) return 1;
+    if (isA) return -1;
+    return 0;
+  });
+}
+
+const findLink = (links, to) => links.find(link => link.to === to);
+
+const slugToTitle = title => title && title.replace(/-/g, " ").split(" ").map(_scule.pascalCase).join(" ");
+
+const getPageLink = page => {
+  const id = page.id;
+  const slug = (page.slug || page.to).split("/").pop();
+  const to = (0, _ufo.withoutTrailingSlash)(page.to || `/${slug}`);
+  const template = typeof page.template === "string" ? {
+    self: page.template,
+    nested: `${page.template}-post`
+  } : page.template;
+  const item = { ...page,
+    ...page.navigation,
+    id,
+    draft: page.draft,
+    language: page.language,
+    slug: page.slug,
+    to,
+    page: typeof page.page !== "undefined" ? page.page : !(page.slug === "" && page.empty && !page.navigation?.redirect),
+    children: [],
+    title: page.title || slugToTitle(to.split("/").pop() || "")
+  };
+
+  if (page.draft) {
+    item.draft = true;
+  }
+
+  if (page.icon) {
+    item.icon = page.icon;
+  }
+
+  if (template) {
+    item.template = template.nested;
+  }
+
+  if (page.navigation === false) {
+    item.hidden = true;
+  }
+
+  return item;
+};
+
+async function generateNavigation(contents) {
+  const defaultLocale = "en";
+
+  if (!contents) {
+    contents = await globalThis.$fetch("/api/_docus/list").then(({
+      items
+    }) => items);
+  }
+
+  contents = sortItems(contents || []);
+  const languages = contents.reduce((map, page) => {
+    const language = page.language || defaultLocale;
+    map[language] = map[language] || [];
+    map[language].push(page);
+    return map;
+  }, {});
+  const navigationArray = Object.entries(languages).map(([language, pages]) => {
+    const body = createNav(pages);
+    return [language, body];
+  });
+  const navigation = Object.fromEntries(navigationArray);
+  return navigation;
+}
+
+function sortWithPosition(links, map) {
+  links.forEach(link => sortWithPosition(link.children || [], map));
+
+  const pos = a => map[a.id] || "999999999999";
+
+  return links.sort((a, b) => pos(a).localeCompare(pos(b)));
+}
+
+function createNav(pages) {
+  const {
+    search: {
+      inheritanceFields
+    }
+  } = (0, _context.useDocusContext)();
+  const pickInheritanceFields = (0, _object.pick)(inheritanceFields);
+  const links = [];
+  const sortMap = {};
+  pages.forEach(_page => {
+    sortMap[_page.id] = String(_page.position);
+    const $page = getPageLink(_page);
+
+    if ($page.slug.startsWith("_")) {
+      return;
+    }
+
+    const dirs = $page.to.split("/").filter(_ => _);
+    const idParts = $page.id.split(/[:/]/);
+
+    if (!dirs.length) {
+      return links.push($page);
+    }
+
+    let currentLinks = links;
+    let lastLink;
+    const parents = [];
+    const root = findLink(currentLinks, "/");
+    if (root) parents.push(root);
+    dirs.forEach((dir, index) => {
+      const to = "/" + dirs.slice(0, index + 1).join("/");
+      if (!currentLinks) return;
+      let link = findLink(currentLinks, to);
+
+      if (!link) {
+        link = getPageLink({
+          id: idParts.slice(0, index + 2).join(":"),
+          slug: dir,
+          to,
+          page: false,
+          position: (0, _utils.generatePosition)(idParts.slice(1, index + 2).join(":"))
+        });
+        sortMap[link.id] = link.position;
+        currentLinks.push(link);
+      }
+
+      currentLinks = link.children;
+      lastLink = link;
+      parents.unshift(link);
+    });
+    Object.assign($page, (0, _defu.default)(pickInheritanceFields($page), ...parents.map(pickInheritanceFields)));
+    if (!currentLinks) return;
+
+    if (lastLink?.to === $page.to) {
+      mergeLinks(lastLink, $page);
+    } else {
+      currentLinks.push($page);
+    }
+  });
+  return sortWithPosition(links, sortMap);
+}
+
+function mergeLinks(to, from) {
+  Object.assign(to, from, {
+    children: [...to.children, ...from.children]
+  });
+}

package/dist/runtime/navigation.mjs

@@ -0,0 +1,137 @@
+import { pascalCase } from "scule";
+import { withoutTrailingSlash } from "ufo";
+import defu from "defu";
+import { pick } from "./utils/object.mjs";
+import { useDocusContext } from "./context.mjs";
+import { generatePosition } from "./transformers/utils/index.mjs";
+const isIndex = (path) => path.endsWith("index.md");
+function sortItems(keys) {
+  return [...keys].sort((a, b) => a.id.localeCompare(b.id)).sort((a, b) => {
+    const isA = isIndex(a.id);
+    const isB = isIndex(b.id);
+    if (isA && isB)
+      return a.id.length - b.id.length;
+    if (isB)
+      return 1;
+    if (isA)
+      return -1;
+    return 0;
+  });
+}
+const findLink = (links, to) => links.find((link) => link.to === to);
+const slugToTitle = (title) => title && title.replace(/-/g, " ").split(" ").map(pascalCase).join(" ");
+const getPageLink = (page) => {
+  const id = page.id;
+  const slug = (page.slug || page.to).split("/").pop();
+  const to = withoutTrailingSlash(page.to || `/${slug}`);
+  const template = typeof page.template === "string" ? { self: page.template, nested: `${page.template}-post` } : page.template;
+  const item = {
+    ...page,
+    ...page.navigation,
+    id,
+    draft: page.draft,
+    language: page.language,
+    slug: page.slug,
+    to,
+    page: typeof page.page !== "undefined" ? page.page : !(page.slug === "" && page.empty && !page.navigation?.redirect),
+    children: [],
+    title: page.title || slugToTitle(to.split("/").pop() || "")
+  };
+  if (page.draft) {
+    item.draft = true;
+  }
+  if (page.icon) {
+    item.icon = page.icon;
+  }
+  if (template) {
+    item.template = template.nested;
+  }
+  if (page.navigation === false) {
+    item.hidden = true;
+  }
+  return item;
+};
+export async function generateNavigation(contents) {
+  const defaultLocale = "en";
+  if (!contents) {
+    contents = await globalThis.$fetch("/api/_docus/list").then(({ items }) => items);
+  }
+  contents = sortItems(contents || []);
+  const languages = contents.reduce((map, page) => {
+    const language = page.language || defaultLocale;
+    map[language] = map[language] || [];
+    map[language].push(page);
+    return map;
+  }, {});
+  const navigationArray = Object.entries(languages).map(([language, pages]) => {
+    const body = createNav(pages);
+    return [language, body];
+  });
+  const navigation = Object.fromEntries(navigationArray);
+  return navigation;
+}
+function sortWithPosition(links, map) {
+  links.forEach((link) => sortWithPosition(link.children || [], map));
+  const pos = (a) => map[a.id] || "999999999999";
+  return links.sort((a, b) => pos(a).localeCompare(pos(b)));
+}
+function createNav(pages) {
+  const {
+    search: { inheritanceFields }
+  } = useDocusContext();
+  const pickInheritanceFields = pick(inheritanceFields);
+  const links = [];
+  const sortMap = {};
+  pages.forEach((_page) => {
+    sortMap[_page.id] = String(_page.position);
+    const $page = getPageLink(_page);
+    if ($page.slug.startsWith("_")) {
+      return;
+    }
+    const dirs = $page.to.split("/").filter((_) => _);
+    const idParts = $page.id.split(/[:/]/);
+    if (!dirs.length) {
+      return links.push($page);
+    }
+    let currentLinks = links;
+    let lastLink;
+    const parents = [];
+    const root = findLink(currentLinks, "/");
+    if (root)
+      parents.push(root);
+    dirs.forEach((dir, index) => {
+      const to = "/" + dirs.slice(0, index + 1).join("/");
+      if (!currentLinks)
+        return;
+      let link = findLink(currentLinks, to);
+      if (!link) {
+        link = getPageLink({
+          id: idParts.slice(0, index + 2).join(":"),
+          slug: dir,
+          to,
+          page: false,
+          position: generatePosition(idParts.slice(1, index + 2).join(":"))
+        });
+        sortMap[link.id] = link.position;
+        currentLinks.push(link);
+      }
+      currentLinks = link.children;
+      lastLink = link;
+      parents.unshift(link);
+    });
+    Object.assign($page, defu(pickInheritanceFields($page), ...parents.map(pickInheritanceFields)));
+    if (!currentLinks)
+      return;
+    if (lastLink?.to === $page.to) {
+      mergeLinks(lastLink, $page);
+    } else {
+      currentLinks.push($page);
+    }
+  });
+  return sortWithPosition(links, sortMap);
+}
+function mergeLinks(to, from) {
+  Object.assign(to, from, {
+    children: [...to.children, ...from.children]
+  });
+}

package/dist/runtime/server/api/get.d.ts

@@ -0,0 +1,10 @@
+import { IncomingMessage } from 'http';
+declare const _default: (req: IncomingMessage) => Promise<{
+    body: MDCRoot;
+    key: string;
+    generatedAt: Date;
+}>;
+/**
+ * Get a content from the database.
+ */
+export default _default;

package/dist/runtime/server/api/get.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+
+var _content = require("../content");
+
+var _utils = require("../utils");
+
+var _default = async req => {
+  const key = (0, _utils.useKey)(req);
+  const previewKey = (0, _utils.usePreview)(req);
+  const content = await (0, _content.getContent)(key, previewKey);
+  return {
+    key,
+    generatedAt: new Date(),
+    ...content.meta,
+    body: content.body
+  };
+};
+
+module.exports = _default;

package/dist/runtime/server/api/get.mjs

@@ -0,0 +1,13 @@
+import { getContent } from "../content.mjs";
+import { useKey, usePreview } from "../utils/index.mjs";
+export default async (req) => {
+  const key = useKey(req);
+  const previewKey = usePreview(req);
+  const content = await getContent(key, previewKey);
+  return {
+    key,
+    generatedAt: new Date(),
+    ...content.meta,
+    body: content.body
+  };
+};

package/dist/runtime/server/api/list.d.ts

@@ -0,0 +1,9 @@
+import { IncomingMessage } from 'http';
+declare const _default: (req: IncomingMessage) => Promise<{
+    generatedAt: Date;
+    items: any[];
+}>;
+/**
+ * List a contents from the database.
+ */
+export default _default;

package/dist/runtime/server/api/list.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+
+var _h = require("h3");
+
+var _content = require("../content");
+
+var _utils = require("../utils");
+
+var _default = async req => {
+  const key = (0, _utils.useKey)(req);
+  const previewKey = (0, _utils.usePreview)(req);
+  let items = await (0, _content.getList)(key, previewKey);
+  const {
+    q
+  } = (0, _h.useQuery)(req);
+
+  if (q) {
+    items = items.filter(item => {
+      return item.id.includes(String(q)) || (item.meta.title || "").includes(q);
+    });
+  }
+
+  return {
+    generatedAt: new Date(),
+    items
+  };
+};
+
+module.exports = _default;

package/dist/runtime/server/api/list.mjs

@@ -0,0 +1,18 @@
+import { useQuery } from "h3";
+import { getList } from "../content.mjs";
+import { useKey, usePreview } from "../utils/index.mjs";
+export default async (req) => {
+  const key = useKey(req);
+  const previewKey = usePreview(req);
+  let items = await getList(key, previewKey);
+  const { q } = useQuery(req);
+  if (q) {
+    items = items.filter((item) => {
+      return item.id.includes(String(q)) || (item.meta.title || "").includes(q);
+    });
+  }
+  return {
+    generatedAt: new Date(),
+    items
+  };
+};

package/dist/runtime/server/api/navigation.d.ts

@@ -0,0 +1,7 @@
+import { IncomingMessage } from 'http';
+declare const _default: (req: IncomingMessage) => Promise<any>;
+/**
+ * Get the navigation object from the database.
+ * Also supports getting it by localization.
+ */
+export default _default;

package/dist/runtime/server/api/navigation.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+
+var _content = require("../content");
+
+var _utils = require("../utils");
+
+var _default = async req => {
+  const key = (0, _utils.useKey)(req);
+  const previewKey = (0, _utils.usePreview)(req);
+  const result = await (0, _content.getNavigation)(previewKey);
+  if (result[key]) return result[key];
+  return result;
+};
+
+module.exports = _default;

package/dist/runtime/server/api/navigation.mjs

@@ -0,0 +1,10 @@
+import { getNavigation } from "../content.mjs";
+import { useKey, usePreview } from "../utils/index.mjs";
+export default async (req) => {
+  const key = useKey(req);
+  const previewKey = usePreview(req);
+  const result = await getNavigation(previewKey);
+  if (result[key])
+    return result[key];
+  return result;
+};

package/dist/runtime/server/api/preview.d.ts

@@ -0,0 +1,3 @@
+import { IncomingMessage } from 'http';
+declare const _default: (req: IncomingMessage) => Promise<import("unstorage/dist/types-20f3bd04").a>;
+export default _default;

package/dist/runtime/server/api/preview.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+
+var _h = require("h3");
+
+var _content = require("../content");
+
+var _utils = require("../utils");
+
+var _default = async req => {
+  const preview = (0, _utils.usePreview)(req);
+  const key = (preview ? preview + ":" : "") + (0, _utils.useKey)(req);
+
+  switch (req.method) {
+    case "DELETE":
+      if (key) {
+        await _content.previewStorage.removeItem(key);
+      } else {
+        await _content.previewStorage.clear();
+      }
+
+      break;
+
+    case "POST":
+      {
+        let body = req.body || (await (0, _h.useBody)(req));
+
+        if (typeof body === "string") {
+          body = JSON.parse(body);
+        }
+
+        await _content.previewStorage.setItem((preview ? preview + ":" : "") + body.key, body.content);
+        break;
+      }
+
+    case "GET":
+      if (key) {
+        return await _content.previewStorage.getKeys();
+      } else {
+        return await _content.previewStorage.getItem(key);
+      }
+
+  }
+
+  return {
+    success: 1
+  };
+};
+
+module.exports = _default;

package/dist/runtime/server/api/preview.mjs

@@ -0,0 +1,31 @@
+import { useBody } from "h3";
+import { previewStorage } from "../content.mjs";
+import { useKey, usePreview } from "../utils/index.mjs";
+export default async (req) => {
+  const preview = usePreview(req);
+  const key = (preview ? preview + ":" : "") + useKey(req);
+  switch (req.method) {
+    case "DELETE":
+      if (key) {
+        await previewStorage.removeItem(key);
+      } else {
+        await previewStorage.clear();
+      }
+      break;
+    case "POST": {
+      let body = req.body || await useBody(req);
+      if (typeof body === "string") {
+        body = JSON.parse(body);
+      }
+      await previewStorage.setItem((preview ? preview + ":" : "") + body.key, body.content);
+      break;
+    }
+    case "GET":
+      if (key) {
+        return await previewStorage.getKeys();
+      } else {
+        return await previewStorage.getItem(key);
+      }
+  }
+  return { success: 1 };
+};

package/dist/runtime/server/api/reload.d.ts

@@ -0,0 +1,6 @@
+import { IncomingMessage } from 'http';
+declare const _default: (req: IncomingMessage) => Promise<boolean>;
+/**
+ * Reload the database.
+ */
+export default _default;

package/dist/runtime/server/api/reload.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+
+var _h = require("h3");
+
+var _content = require("../content");
+
+var _default = async req => {
+  const {
+    key,
+    event
+  } = await (0, _h.useBody)(req);
+
+  if (event === "remove") {
+    _content.buildStorage.removeItem(key);
+  } else if (await _content.buildStorage.hasItem(key)) {
+    await (0, _content.buildContent)(key);
+  }
+
+  return true;
+};
+
+module.exports = _default;

package/dist/runtime/server/api/reload.mjs

@@ -0,0 +1,11 @@
+import { useBody } from "h3";
+import { buildContent, buildStorage } from "../content.mjs";
+export default async (req) => {
+  const { key, event } = await useBody(req);
+  if (event === "remove") {
+    buildStorage.removeItem(key);
+  } else if (await buildStorage.hasItem(key)) {
+    await buildContent(key);
+  }
+  return true;
+};

package/dist/runtime/server/api/search.d.ts

@@ -0,0 +1,6 @@
+import { IncomingMessage } from 'http';
+declare const _default: (req: IncomingMessage) => Promise<any>;
+/**
+ * Search content from the database.
+ */
+export default _default;

package/dist/runtime/server/api/search.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+
+var _h = require("h3");
+
+var _content = require("../content");
+
+var _utils = require("../utils");
+
+var _default = async req => {
+  const key = (0, _utils.useKey)(req);
+  const previewKey = (0, _utils.usePreview)(req);
+  let body = req.body || (await (0, _h.useBody)(req));
+
+  if (typeof body === "string") {
+    body = JSON.parse(body);
+  }
+
+  const result = await (0, _content.searchContent)(key, body || {}, previewKey);
+  return result;
+};
+
+module.exports = _default;

package/dist/runtime/server/api/search.mjs

@@ -0,0 +1,13 @@
+import { useBody } from "h3";
+import { searchContent } from "../content.mjs";
+import { useKey, usePreview } from "../utils/index.mjs";
+export default async (req) => {
+  const key = useKey(req);
+  const previewKey = usePreview(req);
+  let body = req.body || await useBody(req);
+  if (typeof body === "string") {
+    body = JSON.parse(body);
+  }
+  const result = await searchContent(key, body || {}, previewKey);
+  return result;
+};