@xyd-js/uniform 0.0.0-build

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @xyd-js/uniform
+
+## 0.0.0-build+6952c2c-20250813013245
+
+### Patch Changes
+
+- update all packages
+- Updated dependencies
+  - @xyd-js/core@0.0.0-build+6952c2c-20250813013245

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xyd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,3 @@
+# @xyd-js/uniform
+
+uniform is a collection of common interfaces and utils for xyd api reference content.

package/content.ts

@@ -0,0 +1 @@
+export * from "./src/content/index"

package/dist/content.cjs

@@ -0,0 +1,133 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// content.ts
+var content_exports = {};
+__export(content_exports, {
+  compileBySlug: () => compileBySlug,
+  lazyReferences: () => lazyReferences
+});
+module.exports = __toCommonJS(content_exports);
+
+// src/content/index.ts
+var import_path = __toESM(require("path"), 1);
+var import_fs = require("fs");
+var import_react = __toESM(require("react"), 1);
+var import_codehike = require("codehike");
+var import_unist_util_visit = require("unist-util-visit");
+var import_mdx = require("codehike/mdx");
+var import_mdx2 = require("@mdx-js/mdx");
+var codeHikeOptions = {
+  lineNumbers: true,
+  showCopyButton: true,
+  autoImport: true,
+  components: { code: "Code" }
+  // syntaxHighlighting: { // TODO: !!! FROM SETTINGS !!! wait for rr7 rsc ??
+  //     theme: "github-dark",
+  // },
+};
+function normalizeCustomHeadings() {
+  return (tree) => {
+    (0, import_unist_util_visit.visit)(tree, "paragraph", (node, index, parent) => {
+      const match = node.children[0] && node.children[0].value.match(/^(#+)\s+(.*)/);
+      if (match) {
+        const level = match[1].length;
+        const text = match[2];
+        if (level > 6) {
+          const headingNode = {
+            type: "heading",
+            depth: level,
+            children: [{ type: "text", value: text }]
+          };
+          parent.children[index] = headingNode;
+        }
+      }
+    });
+  };
+}
+async function compile(content) {
+  const compiled = await (0, import_mdx2.compile)(content, {
+    remarkPlugins: [normalizeCustomHeadings, [import_mdx.remarkCodeHike, codeHikeOptions]],
+    recmaPlugins: [
+      [import_mdx.recmaCodeHike, codeHikeOptions]
+    ],
+    outputFormat: "function-body",
+    development: false
+  });
+  return String(compiled);
+}
+async function compileBySlug(slug) {
+  const filePath = import_path.default.join(process.cwd(), `${slug}.md`);
+  try {
+    await import_fs.promises.access(filePath);
+  } catch (e) {
+    console.error(e);
+    return "";
+  }
+  const content = await import_fs.promises.readFile(filePath, "utf-8");
+  return await compile(content);
+}
+function getMDXComponent(code) {
+  const mdxExport = getMDXExport(code);
+  return mdxExport.default;
+}
+function getMDXExport(code) {
+  const scope = {
+    Fragment: import_react.default.Fragment,
+    jsxs: import_react.default.createElement,
+    jsx: import_react.default.createElement,
+    jsxDEV: import_react.default.createElement
+  };
+  const fn = new Function(...Object.keys(scope), code);
+  return fn(scope);
+}
+async function lazyReferences(mod) {
+  const references = [];
+  if (Array.isArray(mod.default)) {
+    for (const chunk of mod.default) {
+      try {
+        const code = await compile(chunk);
+        const Content = getMDXComponent(code);
+        const content = Content ? (0, import_codehike.parse)(Content) : null;
+        references.push(...content.references);
+      } catch (e) {
+        console.error(e);
+      }
+    }
+  } else {
+    console.warn(`mod.default is not an array, current type is: ${typeof mod.default}`);
+  }
+  return references;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  compileBySlug,
+  lazyReferences
+});
+//# sourceMappingURL=content.cjs.map

package/dist/content.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../content.ts","../src/content/index.ts"],"sourcesContent":["export * from \"./src/content/index\"","import path from \"path\";\nimport {promises as fs} from \"fs\";\n\nimport React from \"react\";\nimport {parse} from \"codehike\";\nimport {visit} from \"unist-util-visit\";\nimport {recmaCodeHike, remarkCodeHike} from \"codehike/mdx\";\nimport {compile as mdxCompile} from \"@mdx-js/mdx\";\n\nconst codeHikeOptions = {\n    lineNumbers: true,\n    showCopyButton: true,\n    autoImport: true,\n    components: {code: \"Code\"},\n    // syntaxHighlighting: { // TODO: !!! FROM SETTINGS !!! wait for rr7 rsc ??\n    //     theme: \"github-dark\",\n    // },\n};\n//\n// // since unist does not support heading level > 6, we need to normalize them\nfunction normalizeCustomHeadings() {\n    return (tree: any) => {\n        visit(tree, 'paragraph', (node, index, parent) => {\n            const match = node.children[0] && node.children[0].value.match(/^(#+)\\s+(.*)/);\n            if (match) {\n                const level = match[1].length;\n                const text = match[2];\n                if (level > 6) {\n                    // Create a new heading node with depth 6\n                    const headingNode = {\n                        type: 'heading',\n                        depth: level,\n                        children: [{type: 'text', value: text}]\n                    };\n                    // Replace the paragraph node with the new heading node\n                    //@ts-ignore\n                    parent.children[index] = headingNode;\n                }\n            }\n        });\n    };\n}\n\n//\nasync function compile(content: string): Promise<string> {\n    const compiled = await mdxCompile(content, {\n        remarkPlugins: [normalizeCustomHeadings, [remarkCodeHike, codeHikeOptions]],\n        recmaPlugins: [\n            [recmaCodeHike, codeHikeOptions]\n        ],\n        outputFormat: 'function-body',\n        development: false,\n    });\n\n    return String(compiled)\n}\n\nasync function compileBySlug(slug: string) {\n    // TODO: cwd ?\n    const filePath = path.join(process.cwd(), `${slug}.md`)\n\n    try {\n        await fs.access(filePath)\n    } catch (e) {\n        console.error(e)\n        return \"\"\n    }\n\n    const content = await fs.readFile(filePath, \"utf-8\");\n\n    return await compile(content)\n}\n\nfunction getMDXComponent(code: string) {\n    const mdxExport = getMDXExport(code)\n    return mdxExport.default\n}\n\nfunction getMDXExport(code: string) {\n    const scope = {\n        Fragment: React.Fragment,\n        jsxs: React.createElement,\n        jsx: React.createElement,\n        jsxDEV: React.createElement,\n    }\n    const fn = new Function(...Object.keys(scope), code)\n    return fn(scope)\n}\n\n//\n// function MDXContent(code: string) {\n//     return React.useMemo(\n//         () => code ? getMDXComponent(code) : null,\n//         [code]\n//     )\n// }\n\n// TODO: mod ts\nasync function lazyReferences(mod: any) {\n    const references: any[] = []\n\n    if (Array.isArray(mod.default)) {\n        for (const chunk of mod.default) {\n            try {\n                const code = await compile(chunk) // TODO: do we need real path?\n                const Content = getMDXComponent(code)\n                const content = Content ? parse(Content) : null\n\n                references.push(...content.references as [])\n            } catch (e) {\n                console.error(e)\n            }\n        }\n    } else {\n        console.warn(`mod.default is not an array, current type is: ${typeof mod.default}`)\n    }\n\n    return references\n}\n\nexport {\n    compileBySlug,\n    lazyReferences\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAiB;AACjB,gBAA6B;AAE7B,mBAAkB;AAClB,sBAAoB;AACpB,8BAAoB;AACpB,iBAA4C;AAC5C,IAAAA,cAAoC;AAEpC,IAAM,kBAAkB;AAAA,EACpB,aAAa;AAAA,EACb,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,YAAY,EAAC,MAAM,OAAM;AAAA;AAAA;AAAA;AAI7B;AAGA,SAAS,0BAA0B;AAC/B,SAAO,CAAC,SAAc;AAClB,uCAAM,MAAM,aAAa,CAAC,MAAM,OAAO,WAAW;AAC9C,YAAM,QAAQ,KAAK,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,MAAM,MAAM,cAAc;AAC7E,UAAI,OAAO;AACP,cAAM,QAAQ,MAAM,CAAC,EAAE;AACvB,cAAM,OAAO,MAAM,CAAC;AACpB,YAAI,QAAQ,GAAG;AAEX,gBAAM,cAAc;AAAA,YAChB,MAAM;AAAA,YACN,OAAO;AAAA,YACP,UAAU,CAAC,EAAC,MAAM,QAAQ,OAAO,KAAI,CAAC;AAAA,UAC1C;AAGA,iBAAO,SAAS,KAAK,IAAI;AAAA,QAC7B;AAAA,MACJ;AAAA,IACJ,CAAC;AAAA,EACL;AACJ;AAGA,eAAe,QAAQ,SAAkC;AACrD,QAAM,WAAW,UAAM,YAAAC,SAAW,SAAS;AAAA,IACvC,eAAe,CAAC,yBAAyB,CAAC,2BAAgB,eAAe,CAAC;AAAA,IAC1E,cAAc;AAAA,MACV,CAAC,0BAAe,eAAe;AAAA,IACnC;AAAA,IACA,cAAc;AAAA,IACd,aAAa;AAAA,EACjB,CAAC;AAED,SAAO,OAAO,QAAQ;AAC1B;AAEA,eAAe,cAAc,MAAc;AAEvC,QAAM,WAAW,YAAAC,QAAK,KAAK,QAAQ,IAAI,GAAG,GAAG,IAAI,KAAK;AAEtD,MAAI;AACA,UAAM,UAAAC,SAAG,OAAO,QAAQ;AAAA,EAC5B,SAAS,GAAG;AACR,YAAQ,MAAM,CAAC;AACf,WAAO;AAAA,EACX;AAEA,QAAM,UAAU,MAAM,UAAAA,SAAG,SAAS,UAAU,OAAO;AAEnD,SAAO,MAAM,QAAQ,OAAO;AAChC;AAEA,SAAS,gBAAgB,MAAc;AACnC,QAAM,YAAY,aAAa,IAAI;AACnC,SAAO,UAAU;AACrB;AAEA,SAAS,aAAa,MAAc;AAChC,QAAM,QAAQ;AAAA,IACV,UAAU,aAAAC,QAAM;AAAA,IAChB,MAAM,aAAAA,QAAM;AAAA,IACZ,KAAK,aAAAA,QAAM;AAAA,IACX,QAAQ,aAAAA,QAAM;AAAA,EAClB;AACA,QAAM,KAAK,IAAI,SAAS,GAAG,OAAO,KAAK,KAAK,GAAG,IAAI;AACnD,SAAO,GAAG,KAAK;AACnB;AAWA,eAAe,eAAe,KAAU;AACpC,QAAM,aAAoB,CAAC;AAE3B,MAAI,MAAM,QAAQ,IAAI,OAAO,GAAG;AAC5B,eAAW,SAAS,IAAI,SAAS;AAC7B,UAAI;AACA,cAAM,OAAO,MAAM,QAAQ,KAAK;AAChC,cAAM,UAAU,gBAAgB,IAAI;AACpC,cAAM,UAAU,cAAU,uBAAM,OAAO,IAAI;AAE3C,mBAAW,KAAK,GAAG,QAAQ,UAAgB;AAAA,MAC/C,SAAS,GAAG;AACR,gBAAQ,MAAM,CAAC;AAAA,MACnB;AAAA,IACJ;AAAA,EACJ,OAAO;AACH,YAAQ,KAAK,iDAAiD,OAAO,IAAI,OAAO,EAAE;AAAA,EACtF;AAEA,SAAO;AACX;","names":["import_mdx","mdxCompile","path","fs","React"]}

package/dist/content.d.cts

@@ -0,0 +1,4 @@
+declare function compileBySlug(slug: string): Promise<string>;
+declare function lazyReferences(mod: any): Promise<any[]>;
+
+export { compileBySlug, lazyReferences };

package/dist/content.d.ts

@@ -0,0 +1,4 @@
+declare function compileBySlug(slug: string): Promise<string>;
+declare function lazyReferences(mod: any): Promise<any[]>;
+
+export { compileBySlug, lazyReferences };

package/dist/content.js

@@ -0,0 +1,95 @@
+// src/content/index.ts
+import path from "path";
+import { promises as fs } from "fs";
+import React from "react";
+import { parse } from "codehike";
+import { visit } from "unist-util-visit";
+import { recmaCodeHike, remarkCodeHike } from "codehike/mdx";
+import { compile as mdxCompile } from "@mdx-js/mdx";
+var codeHikeOptions = {
+  lineNumbers: true,
+  showCopyButton: true,
+  autoImport: true,
+  components: { code: "Code" }
+  // syntaxHighlighting: { // TODO: !!! FROM SETTINGS !!! wait for rr7 rsc ??
+  //     theme: "github-dark",
+  // },
+};
+function normalizeCustomHeadings() {
+  return (tree) => {
+    visit(tree, "paragraph", (node, index, parent) => {
+      const match = node.children[0] && node.children[0].value.match(/^(#+)\s+(.*)/);
+      if (match) {
+        const level = match[1].length;
+        const text = match[2];
+        if (level > 6) {
+          const headingNode = {
+            type: "heading",
+            depth: level,
+            children: [{ type: "text", value: text }]
+          };
+          parent.children[index] = headingNode;
+        }
+      }
+    });
+  };
+}
+async function compile(content) {
+  const compiled = await mdxCompile(content, {
+    remarkPlugins: [normalizeCustomHeadings, [remarkCodeHike, codeHikeOptions]],
+    recmaPlugins: [
+      [recmaCodeHike, codeHikeOptions]
+    ],
+    outputFormat: "function-body",
+    development: false
+  });
+  return String(compiled);
+}
+async function compileBySlug(slug) {
+  const filePath = path.join(process.cwd(), `${slug}.md`);
+  try {
+    await fs.access(filePath);
+  } catch (e) {
+    console.error(e);
+    return "";
+  }
+  const content = await fs.readFile(filePath, "utf-8");
+  return await compile(content);
+}
+function getMDXComponent(code) {
+  const mdxExport = getMDXExport(code);
+  return mdxExport.default;
+}
+function getMDXExport(code) {
+  const scope = {
+    Fragment: React.Fragment,
+    jsxs: React.createElement,
+    jsx: React.createElement,
+    jsxDEV: React.createElement
+  };
+  const fn = new Function(...Object.keys(scope), code);
+  return fn(scope);
+}
+async function lazyReferences(mod) {
+  const references = [];
+  if (Array.isArray(mod.default)) {
+    for (const chunk of mod.default) {
+      try {
+        const code = await compile(chunk);
+        const Content = getMDXComponent(code);
+        const content = Content ? parse(Content) : null;
+        references.push(...content.references);
+      } catch (e) {
+        console.error(e);
+      }
+    }
+  } else {
+    console.warn(`mod.default is not an array, current type is: ${typeof mod.default}`);
+  }
+  return references;
+}
+export {
+  compileBySlug,
+  lazyReferences
+};
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/content/index.ts"],"sourcesContent":["import path from \"path\";\nimport {promises as fs} from \"fs\";\n\nimport React from \"react\";\nimport {parse} from \"codehike\";\nimport {visit} from \"unist-util-visit\";\nimport {recmaCodeHike, remarkCodeHike} from \"codehike/mdx\";\nimport {compile as mdxCompile} from \"@mdx-js/mdx\";\n\nconst codeHikeOptions = {\n    lineNumbers: true,\n    showCopyButton: true,\n    autoImport: true,\n    components: {code: \"Code\"},\n    // syntaxHighlighting: { // TODO: !!! FROM SETTINGS !!! wait for rr7 rsc ??\n    //     theme: \"github-dark\",\n    // },\n};\n//\n// // since unist does not support heading level > 6, we need to normalize them\nfunction normalizeCustomHeadings() {\n    return (tree: any) => {\n        visit(tree, 'paragraph', (node, index, parent) => {\n            const match = node.children[0] && node.children[0].value.match(/^(#+)\\s+(.*)/);\n            if (match) {\n                const level = match[1].length;\n                const text = match[2];\n                if (level > 6) {\n                    // Create a new heading node with depth 6\n                    const headingNode = {\n                        type: 'heading',\n                        depth: level,\n                        children: [{type: 'text', value: text}]\n                    };\n                    // Replace the paragraph node with the new heading node\n                    //@ts-ignore\n                    parent.children[index] = headingNode;\n                }\n            }\n        });\n    };\n}\n\n//\nasync function compile(content: string): Promise<string> {\n    const compiled = await mdxCompile(content, {\n        remarkPlugins: [normalizeCustomHeadings, [remarkCodeHike, codeHikeOptions]],\n        recmaPlugins: [\n            [recmaCodeHike, codeHikeOptions]\n        ],\n        outputFormat: 'function-body',\n        development: false,\n    });\n\n    return String(compiled)\n}\n\nasync function compileBySlug(slug: string) {\n    // TODO: cwd ?\n    const filePath = path.join(process.cwd(), `${slug}.md`)\n\n    try {\n        await fs.access(filePath)\n    } catch (e) {\n        console.error(e)\n        return \"\"\n    }\n\n    const content = await fs.readFile(filePath, \"utf-8\");\n\n    return await compile(content)\n}\n\nfunction getMDXComponent(code: string) {\n    const mdxExport = getMDXExport(code)\n    return mdxExport.default\n}\n\nfunction getMDXExport(code: string) {\n    const scope = {\n        Fragment: React.Fragment,\n        jsxs: React.createElement,\n        jsx: React.createElement,\n        jsxDEV: React.createElement,\n    }\n    const fn = new Function(...Object.keys(scope), code)\n    return fn(scope)\n}\n\n//\n// function MDXContent(code: string) {\n//     return React.useMemo(\n//         () => code ? getMDXComponent(code) : null,\n//         [code]\n//     )\n// }\n\n// TODO: mod ts\nasync function lazyReferences(mod: any) {\n    const references: any[] = []\n\n    if (Array.isArray(mod.default)) {\n        for (const chunk of mod.default) {\n            try {\n                const code = await compile(chunk) // TODO: do we need real path?\n                const Content = getMDXComponent(code)\n                const content = Content ? parse(Content) : null\n\n                references.push(...content.references as [])\n            } catch (e) {\n                console.error(e)\n            }\n        }\n    } else {\n        console.warn(`mod.default is not an array, current type is: ${typeof mod.default}`)\n    }\n\n    return references\n}\n\nexport {\n    compileBySlug,\n    lazyReferences\n}\n"],"mappings":";AAAA,OAAO,UAAU;AACjB,SAAQ,YAAY,UAAS;AAE7B,OAAO,WAAW;AAClB,SAAQ,aAAY;AACpB,SAAQ,aAAY;AACpB,SAAQ,eAAe,sBAAqB;AAC5C,SAAQ,WAAW,kBAAiB;AAEpC,IAAM,kBAAkB;AAAA,EACpB,aAAa;AAAA,EACb,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,YAAY,EAAC,MAAM,OAAM;AAAA;AAAA;AAAA;AAI7B;AAGA,SAAS,0BAA0B;AAC/B,SAAO,CAAC,SAAc;AAClB,UAAM,MAAM,aAAa,CAAC,MAAM,OAAO,WAAW;AAC9C,YAAM,QAAQ,KAAK,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,MAAM,MAAM,cAAc;AAC7E,UAAI,OAAO;AACP,cAAM,QAAQ,MAAM,CAAC,EAAE;AACvB,cAAM,OAAO,MAAM,CAAC;AACpB,YAAI,QAAQ,GAAG;AAEX,gBAAM,cAAc;AAAA,YAChB,MAAM;AAAA,YACN,OAAO;AAAA,YACP,UAAU,CAAC,EAAC,MAAM,QAAQ,OAAO,KAAI,CAAC;AAAA,UAC1C;AAGA,iBAAO,SAAS,KAAK,IAAI;AAAA,QAC7B;AAAA,MACJ;AAAA,IACJ,CAAC;AAAA,EACL;AACJ;AAGA,eAAe,QAAQ,SAAkC;AACrD,QAAM,WAAW,MAAM,WAAW,SAAS;AAAA,IACvC,eAAe,CAAC,yBAAyB,CAAC,gBAAgB,eAAe,CAAC;AAAA,IAC1E,cAAc;AAAA,MACV,CAAC,eAAe,eAAe;AAAA,IACnC;AAAA,IACA,cAAc;AAAA,IACd,aAAa;AAAA,EACjB,CAAC;AAED,SAAO,OAAO,QAAQ;AAC1B;AAEA,eAAe,cAAc,MAAc;AAEvC,QAAM,WAAW,KAAK,KAAK,QAAQ,IAAI,GAAG,GAAG,IAAI,KAAK;AAEtD,MAAI;AACA,UAAM,GAAG,OAAO,QAAQ;AAAA,EAC5B,SAAS,GAAG;AACR,YAAQ,MAAM,CAAC;AACf,WAAO;AAAA,EACX;AAEA,QAAM,UAAU,MAAM,GAAG,SAAS,UAAU,OAAO;AAEnD,SAAO,MAAM,QAAQ,OAAO;AAChC;AAEA,SAAS,gBAAgB,MAAc;AACnC,QAAM,YAAY,aAAa,IAAI;AACnC,SAAO,UAAU;AACrB;AAEA,SAAS,aAAa,MAAc;AAChC,QAAM,QAAQ;AAAA,IACV,UAAU,MAAM;AAAA,IAChB,MAAM,MAAM;AAAA,IACZ,KAAK,MAAM;AAAA,IACX,QAAQ,MAAM;AAAA,EAClB;AACA,QAAM,KAAK,IAAI,SAAS,GAAG,OAAO,KAAK,KAAK,GAAG,IAAI;AACnD,SAAO,GAAG,KAAK;AACnB;AAWA,eAAe,eAAe,KAAU;AACpC,QAAM,aAAoB,CAAC;AAE3B,MAAI,MAAM,QAAQ,IAAI,OAAO,GAAG;AAC5B,eAAW,SAAS,IAAI,SAAS;AAC7B,UAAI;AACA,cAAM,OAAO,MAAM,QAAQ,KAAK;AAChC,cAAM,UAAU,gBAAgB,IAAI;AACpC,cAAM,UAAU,UAAU,MAAM,OAAO,IAAI;AAE3C,mBAAW,KAAK,GAAG,QAAQ,UAAgB;AAAA,MAC/C,SAAS,GAAG;AACR,gBAAQ,MAAM,CAAC;AAAA,MACnB;AAAA,IACJ;AAAA,EACJ,OAAO;AACH,YAAQ,KAAK,iDAAiD,OAAO,IAAI,OAAO,EAAE;AAAA,EACtF;AAEA,SAAO;AACX;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,235 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFINED_DEFINITION_PROPERTY_TYPE: () => DEFINED_DEFINITION_PROPERTY_TYPE,
+  ReferenceCategory: () => ReferenceCategory,
+  ReferenceType: () => ReferenceType,
+  default: () => uniform,
+  pluginJsonView: () => pluginJsonView,
+  pluginNavigation: () => pluginNavigation
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var DEFINED_DEFINITION_PROPERTY_TYPE = /* @__PURE__ */ ((DEFINED_DEFINITION_PROPERTY_TYPE2) => {
+  DEFINED_DEFINITION_PROPERTY_TYPE2["UNION"] = "$$union";
+  DEFINED_DEFINITION_PROPERTY_TYPE2["XOR"] = "$$xor";
+  DEFINED_DEFINITION_PROPERTY_TYPE2["ARRAY"] = "$$array";
+  DEFINED_DEFINITION_PROPERTY_TYPE2["ENUM"] = "$$enum";
+  return DEFINED_DEFINITION_PROPERTY_TYPE2;
+})(DEFINED_DEFINITION_PROPERTY_TYPE || {});
+var ReferenceCategory = /* @__PURE__ */ ((ReferenceCategory2) => {
+  ReferenceCategory2["COMPONENTS"] = "components";
+  ReferenceCategory2["HOOKS"] = "hooks";
+  ReferenceCategory2["REST"] = "rest";
+  ReferenceCategory2["GRAPHQL"] = "graphql";
+  ReferenceCategory2["FUNCTIONS"] = "functions";
+  return ReferenceCategory2;
+})(ReferenceCategory || {});
+var ReferenceType = /* @__PURE__ */ ((ReferenceType2) => {
+  ReferenceType2["COMPONENT"] = "component";
+  ReferenceType2["HOOK"] = "hook";
+  ReferenceType2["REST_HTTP_GET"] = "rest_get";
+  ReferenceType2["REST_HTTP_POST"] = "rest_post";
+  ReferenceType2["REST_HTTP_PUT"] = "rest_put";
+  ReferenceType2["REST_HTTP_PATCH"] = "rest_patch";
+  ReferenceType2["REST_HTTP_DELETE"] = "rest_delete";
+  ReferenceType2["REST_HTTP_OPTIONS"] = "rest_options";
+  ReferenceType2["REST_HTTP_HEAD"] = "rest_head";
+  ReferenceType2["REST_HTTP_TRACE"] = "rest_trace";
+  ReferenceType2["REST_COMPONENT_SCHEMA"] = "rest_component_schema";
+  ReferenceType2["GRAPHQL_QUERY"] = "graphql_query";
+  ReferenceType2["GRAPHQL_MUTATION"] = "graphql_mutation";
+  ReferenceType2["GRAPHQL_SUBSCRIPTION"] = "graphql_subscription";
+  ReferenceType2["GRAPHQL_SCALAR"] = "graphql_scalar";
+  ReferenceType2["GRAPHQL_OBJECT"] = "graphql_object";
+  ReferenceType2["GRAPHQL_INTERFACE"] = "graphql_interface";
+  ReferenceType2["GRAPHQL_UNION"] = "graphql_union";
+  ReferenceType2["GRAPHQL_ENUM"] = "graphql_enum";
+  ReferenceType2["GRAPHQL_INPUT"] = "graphql_input";
+  ReferenceType2["FUNCTION_JS"] = "function_js";
+  return ReferenceType2;
+})(ReferenceType || {});
+
+// src/index.ts
+function uniform(references, config) {
+  const response = {
+    references,
+    out: {}
+  };
+  config.plugins.forEach((plugin) => {
+    let defer = void 0;
+    const call = plugin({
+      references,
+      defer: (cb) => {
+        if (typeof cb === "function") {
+          defer = cb;
+        }
+      }
+      // visit: (pattern, callback) => {
+      // }
+    });
+    references.map((ref, i) => {
+      call(ref, {
+        index: i
+      });
+    });
+    if (typeof defer === "function") {
+      const resp = defer();
+      if (typeof resp !== "object") {
+        throw new Error(`Invalid callback return type: ${typeof resp}`);
+      }
+      response.out = {
+        ...response.out,
+        ...resp
+      };
+    }
+  });
+  return response;
+}
+
+// src/plugins/pluginJsonView.ts
+function pluginJsonView(options) {
+  return function pluginJsonViewInner({
+    defer
+  }) {
+    const jsonViews = [];
+    defer(() => ({
+      jsonViews
+    }));
+    return (ref) => {
+      const lines = [];
+      lines.push("{");
+      ref.definitions.forEach((def) => {
+        def.properties.forEach((prop, index) => {
+          var _a;
+          const value = (((_a = prop.examples) == null ? void 0 : _a[0]) || "").replace(/^"|"$|[^a-zA-Z0-9\s\-_.,:/@#=;+()]/g, "");
+          const comment = prop.examples && prop.examples.length > 1 ? ` // or "${prop.examples[1].replace(/^"|"$|[^a-zA-Z0-9\s\-_.,:/@#=;+()]/g, "")}"` : "";
+          const isLast = index === def.properties.length - 1;
+          lines.push(`    "${prop.name}": "${value}"${isLast ? "" : ","}${comment}`);
+        });
+      });
+      lines.push("}");
+      jsonViews.push(lines.join("\n"));
+    };
+  };
+}
+
+// src/plugins/pluginNavigation.ts
+var import_node_path = __toESM(require("path"), 1);
+var DEFAULT_VIRTUAL_FOLDER = ".xyd/.cache/.content";
+var DEFAULT_GROUP_NAME = "API Reference";
+function pluginNavigation(settings, options) {
+  if (!options.urlPrefix) {
+    throw new Error("urlPrefix is required");
+  }
+  return function pluginNavigationInner({
+    defer
+  }) {
+    const pageFrontMatter = {};
+    const groupMaps = {};
+    defer(() => ({
+      pageFrontMatter,
+      sidebar: convertGroupMapsToSidebar(settings, groupMaps)
+    }));
+    return (ref) => {
+      const dataCtx = ref.context;
+      const pagePath = import_node_path.default.join(options.urlPrefix, ref.canonical);
+      let group = (dataCtx == null ? void 0 : dataCtx.group) || [];
+      let title = ref.title;
+      if (pageFrontMatter[pagePath]) {
+        console.error("(pluginNavigation): pageFrontMatter[pagePath] already exists", pagePath);
+      }
+      if (!group) {
+        group = [options.defaultGroup || DEFAULT_GROUP_NAME];
+      }
+      pageFrontMatter[pagePath] = {
+        title
+      };
+      if (typeof group === "string") {
+        throw new Error("group as string is not supported yet");
+      }
+      group.reduce((groups, groupName, i) => {
+        if (!groups[groupName]) {
+          groups[groupName] = {
+            __groups: {},
+            pages: /* @__PURE__ */ new Set()
+          };
+        }
+        if (i === group.length - 1) {
+          groups[groupName].pages.add(pagePath);
+        }
+        return groups[groupName].__groups;
+      }, groupMaps);
+    };
+  };
+}
+function convertGroupMapsToSidebar(settings, groupMaps) {
+  const nav = [];
+  Object.keys(groupMaps).map((groupName) => {
+    const current = groupMaps[groupName];
+    const pages = [];
+    current.pages.forEach((page) => {
+      var _a, _b;
+      if ((_b = (_a = settings == null ? void 0 : settings.engine) == null ? void 0 : _a.uniform) == null ? void 0 : _b.store) {
+        pages.push(page);
+        return;
+      }
+      pages.push({
+        virtual: import_node_path.default.join(DEFAULT_VIRTUAL_FOLDER, page),
+        page
+      });
+    });
+    if (Object.keys(current.__groups).length) {
+      const subNav = {
+        group: groupName,
+        pages: convertGroupMapsToSidebar(settings, current.__groups)
+      };
+      nav.push(subNav);
+      return;
+    }
+    nav.push({
+      group: groupName,
+      pages
+    });
+  });
+  return nav;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFINED_DEFINITION_PROPERTY_TYPE,
+  ReferenceCategory,
+  ReferenceType,
+  pluginJsonView,
+  pluginNavigation
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../src/types.ts","../src/index.ts","../src/plugins/pluginJsonView.ts","../src/plugins/pluginNavigation.ts"],"sourcesContent":["export * from \"./src/types\"\nexport type {\n    UniformPlugin,\n    UniformPluginArgs\n} from \"./src/index\"\n\nexport { default } from \"./src/index\"\n\nexport {\n    pluginJsonView,\n    pluginNavigation,\n} from \"./src/plugins\"\n\n\n","import React from \"react\";\nimport {HighlightedCode} from \"codehike/code\";\n\n// TODO: type, and category also as generic?\nexport interface Reference<\n    C = ReferenceContext,\n    M extends DefinitionMeta = DefinitionMeta,\n    VM extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n    description: string | React.ReactNode;\n    canonical: string;\n\n    definitions: Definition<M, VM>[] // TODO: in the future from generic?\n    examples: ExampleRoot\n\n\n    category?: ReferenceCategory; // TODO: do we need that?\n\n    type?: ReferenceType; // TODO: do we need that?\n\n    context?: C;\n\n    /**\n     * TODO: !!!! BETTER !!!!\n     * @internal\n     */\n    __UNSAFE_selector?: (selector: string) => any;\n}\n\nexport type DefinitionOpenAPIMeta = Meta<\"contentType\" | \"required\" | \"definitionDescription\">;\nexport type DefinitionTypeDocMeta = Meta<\"type\">;\nexport type DefinitionGraphqlMeta = Meta<\"type\" | \"graphqlName\">;\n\nexport type DefinitionMeta = DefinitionOpenAPIMeta | DefinitionTypeDocMeta | DefinitionGraphqlMeta\n\nexport type SymbolDef = {\n    id?: string | string[];\n\n    canonical?: string | string[];\n}\n\nexport interface Definition<\n    M extends DefinitionMeta = DefinitionMeta,\n    VM extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n\n    properties: DefinitionProperty[];\n\n    rootProperty?: DefinitionProperty\n\n    variants?: DefinitionVariant<VM>[];\n\n    description?: string | React.ReactNode;\n\n    meta?: M[];\n\n    /**\n     * @internal\n     */\n    symbolDef?: SymbolDef;\n\n    /**\n     * @internal\n     */\n    id?: string;\n\n    /**\n     * @internal\n     */\n    type?: string;\n}\n\nexport type DefinitionVariantOpenAPIMeta = Meta<\"status\" | \"contentType\" | \"definitionDescription\" | \"required\">;\nexport type CommonDefinitionVariantMeta = Meta<\"symbolName\">;\n\nexport type DefinitionVariantMeta = CommonDefinitionVariantMeta | DefinitionVariantOpenAPIMeta\n\nexport interface DefinitionVariant<\n    M extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n\n    properties: DefinitionProperty[];\n\n    rootProperty?: DefinitionProperty\n\n    description?: string | React.ReactNode;\n\n    symbolDef?: SymbolDef;\n\n    meta?: M[];\n}\n\nexport interface Meta<T = string> {\n    name: T;\n\n    value?: unknown; // TODO: better type?\n}\n\nexport type DefinitionPropertyMeta = Meta<\"required\" | \"deprecated\" | \"internal\" | \"defaults\" | \"nullable\" | \"example\" | \"examples\" | \"minimum\" | \"maximum\" | \"enum-type\"> // TODO: better solution than enum-type?\n\nexport enum DEFINED_DEFINITION_PROPERTY_TYPE {\n    UNION = \"$$union\",\n\n    XOR = \"$$xor\",\n\n    ARRAY = \"$$array\",\n\n    ENUM = \"$$enum\",\n\n    // TYPE = \"$$type\", TODO: good idea?\n}\n\nexport interface DefinitionProperty {\n    name: string;\n\n    type: string | DEFINED_DEFINITION_PROPERTY_TYPE\n\n    description: string | React.ReactNode;\n\n    // TODO: in the future more advanced examples?\n    examples?: string | string[];\n\n    symbolDef?: SymbolDef;\n\n    meta?: DefinitionPropertyMeta[];\n\n    context?: any // TODO: better type\n\n    properties?: DefinitionProperty[];\n\n    ofProperty?: DefinitionProperty;\n}\n\nexport interface ExampleRoot {\n    groups: ExampleGroup[];\n}\n\nexport interface ExampleGroup {\n    description?: string;\n\n    examples: Example[];\n}\n\nexport interface Example {\n    description?: string; // TODO: replace with title ?\n\n    codeblock: CodeBlock;\n}\n\nexport interface CodeBlock {\n    title?: string;\n\n    tabs: CodeBlockTab[];\n}\n\nexport interface CodeBlockTab {\n    // title of the tab e.g \"JavaScript\"\n    title: string;\n\n    // code in the tab e.g \"console.log('Hello World')\"\n    code: string\n\n    // language of the code e.g \"js\"\n    language: string;\n\n    // context of the generation method e.g openapi or graphql\n    context?: ExampleContext;\n\n    // TODO: highlighted code\n    highlighted?: HighlightedCode;\n}\n\nexport type ExampleContext = GraphQLExampleContext | OpenAPIExampleContext;\n\n// TODO: concept only\nexport enum ReferenceCategory {\n    // for React\n    COMPONENTS = \"components\",\n    HOOKS = \"hooks\",\n    // end for React\n\n    // for API\n    REST = \"rest\",\n    GRAPHQL = \"graphql\",\n    // end for API\n\n    // for code\n    FUNCTIONS = \"functions\",\n    //\n}\n\n// TODO: concept only\nexport enum ReferenceType {\n    // for React\n    COMPONENT = \"component\",\n    HOOK = \"hook\",\n    // end for React\n\n    // for API\n    // TODO: better type system for specific api typesl like gql or rest\n    REST_HTTP_GET = \"rest_get\",\n    REST_HTTP_POST = \"rest_post\",\n    REST_HTTP_PUT = \"rest_put\",\n    REST_HTTP_PATCH = \"rest_patch\",\n    REST_HTTP_DELETE = \"rest_delete\",\n    REST_HTTP_OPTIONS = \"rest_options\",\n    REST_HTTP_HEAD = \"rest_head\",\n    REST_HTTP_TRACE = \"rest_trace\",\n\n    REST_COMPONENT_SCHEMA = \"rest_component_schema\",\n    // ---\n    GRAPHQL_QUERY = \"graphql_query\",\n    GRAPHQL_MUTATION = \"graphql_mutation\",\n    GRAPHQL_SUBSCRIPTION = \"graphql_subscription\",\n\n    GRAPHQL_SCALAR = \"graphql_scalar\",\n    GRAPHQL_OBJECT = \"graphql_object\",\n    GRAPHQL_INTERFACE = \"graphql_interface\",\n    GRAPHQL_UNION = \"graphql_union\",\n    GRAPHQL_ENUM = \"graphql_enum\",\n    GRAPHQL_INPUT = \"graphql_input\",\n    // end for API\n\n    // for code\n    FUNCTION_JS = \"function_js\",\n    // end for code\n}\n\nexport interface BaseReferenceContext {\n    group?: string[];\n\n    scopes?: string[];\n}\n\nexport interface GraphQLReferenceContext extends BaseReferenceContext {\n    /**\n     * @internal\n     */\n    graphqlTypeShort: string;\n\n    graphqlName: string;\n}\n\n// TODO: custom value?\nexport interface OpenAPIReferenceContext extends BaseReferenceContext {\n    method?: string;\n\n    path?: string;\n\n    fullPath?: string;\n\n    componentSchema?: string\n}\n\nexport type TypeDocReferenceContextMeta = Meta<\"internal\">\n\n// Add TypeDocReferenceContext to the union type\nexport interface TypeDocReferenceContext extends BaseReferenceContext {\n    symbolId: string;\n    symbolName: string;\n    symbolKind: number;\n    packageName: string;\n    fileName: string;\n    fileFullPath: string;\n    line: number;\n    col: number;\n    signatureText: {\n        code: string;\n        lang: string;\n    };\n    sourcecode: {\n        code: string;\n        lang: string;\n    };\n    category?: string;\n    meta?: TypeDocReferenceContextMeta[]\n}\n\nexport type ReferenceContext = GraphQLReferenceContext | OpenAPIReferenceContext | TypeDocReferenceContext\n\nexport interface GraphQLExampleContext {\n    schema?: any; // TODO:\n}\n\nexport interface OpenAPIExampleContext {\n    status?: number;\n\n    content?: string;\n}\n\n\n","// Define the new PluginV type with a callback function that returns another function\nimport {Reference} from \"./types\";\n\nexport * from \"./types\";\n\n// Define the new PluginV type with a callback function that returns another function\nexport type UniformPluginArgs = {\n    references: Reference[] | Reference,\n    defer: (defer: () => any) => void;\n\n    // TODO: maybe in the future\n    // visit: (selector: string | \"[method] [path]\", callback: (...args: any[]) => void) => void;\n}\n\n\nexport type UniformPluginRestArgs = {\n    index: number;\n}\nexport type UniformPlugin<T> = (args: UniformPluginArgs) => (ref: Reference, restArgs: UniformPluginRestArgs) => void;\n\n// Utility type to infer if a type is an array and avoid wrapping it into an array twice\ntype NormalizeArray<T> = T extends Array<infer U> ? U[] : T;\n\n// Infer the return type of the plugin callback properly and normalize array types\ntype PluginResult<T extends UniformPlugin<any>> = T extends UniformPlugin<infer R> ? R : never;\n\n// Merge all plugin return types into a single object and normalize arrays\ntype MergePluginResults<T extends UniformPlugin<any>[]> = {\n    [K in keyof UnionToIntersection<PluginResult<T[number]>>]: NormalizeArray<UnionToIntersection<PluginResult<T[number]>>[K]>\n};\n\n// Utility type to handle intersection to an object type\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\n\n// Implement the uniform function\nexport default function uniform<T extends UniformPlugin<any>[]>(\n    references: Reference[],\n    config: { plugins: T }\n) {\n    // Infer the merged result type from all plugins\n    type ResultType = MergePluginResults<T>;\n\n    // Initialize the response with a type-safe out object\n    const response: {\n        references: Reference[]\n        out: { [K in keyof ResultType]: ResultType[K] }\n    } = {\n        references,\n        out: {} as { [K in keyof ResultType]: ResultType[K] }\n    };\n\n    config.plugins.forEach((plugin) => {\n        let defer: any = undefined; // fix any\n\n        const call = plugin({\n            references: references,\n            defer: (cb) => {\n                if (typeof cb === \"function\") {\n                    defer = cb\n                }\n            },\n            // visit: (pattern, callback) => {\n            // }\n        })\n\n        references.map((ref, i) => {\n            call(ref, {\n                index: i,\n            })\n        });\n\n        if (typeof defer === \"function\") {\n            const resp = defer()\n            if (typeof resp !== \"object\") {\n                throw new Error(`Invalid callback return type: ${typeof resp}`)\n            }\n\n            response.out = {\n                ...response.out,\n                ...resp\n            }\n        }\n    })\n\n    return response;\n}\n\n// Example usage\n// const examplePlugin: UniformPlugin<{ value: boolean }> = (cb) => {\n//     return (ref: Reference) => {\n//     };\n// };\n// function examplePlugin(defer: (defer: () => { value: boolean }) => void) {\n//     defer(() => ({\n//         value: true,\n//     }));\n//\n//     return (ref: Reference) => {\n//\n//     };\n// }\n// const response = uniform([/* references */], {\n//     plugins: [examplePlugin],\n// });\n// response.out\n","import type { UniformPluginArgs, UniformPlugin } from \"../index\";\nimport { Reference } from \"../types\";\n\nexport interface pluginJsonViewOptions {\n}\n\ntype pluginJsonViewOutput = {\n    jsonViews: string;\n}\n\nexport function pluginJsonView(\n    options?: pluginJsonViewOptions\n): UniformPlugin<pluginJsonViewOutput> {\n\n    return function pluginJsonViewInner({\n        defer,\n    }: UniformPluginArgs) {\n        const jsonViews: string[] = [];\n\n        defer(() => ({\n            jsonViews\n        }))\n\n        return (ref: Reference) => {\n            // Build the output string manually to ensure exact format\n            const lines: string[] = [];\n            lines.push('{');\n            \n            ref.definitions.forEach(def => {\n                def.properties.forEach((prop, index) => {\n                    // Remove any quotes and trailing characters from the value\n                    const value = (prop.examples?.[0] || '').replace(/^\"|\"$|[^a-zA-Z0-9\\s\\-_.,:/@#=;+()]/g, '');\n                    const comment = prop.examples && prop.examples.length > 1 \n                        ? ` // or \"${(prop.examples as string[])[1].replace(/^\"|\"$|[^a-zA-Z0-9\\s\\-_.,:/@#=;+()]/g, '')}\"`\n                        : '';\n                    const isLast = index === def.properties.length - 1;\n                    // Add comma after the value but before the comment\n                    lines.push(`    \"${prop.name}\": \"${value}\"${isLast ? '' : ','}${comment}`);\n                });\n            });\n            \n            lines.push('}');\n            \n            jsonViews.push(lines.join('\\n'));\n        }\n    }\n}\n\n// example usage:\n// const response = uniform([/* references */], {\n//     plugins: [pluginJsonView({\n//         \n//     })],\n// });\n","import path from 'node:path';\n\nimport type { Sidebar, Metadata, MetadataMap, Settings, PageURL } from \"@xyd-js/core\";\n\nimport type { UniformPluginArgs, UniformPlugin } from \"../index\";\nimport { CodeBlockTab, Example, ExampleGroup, Reference } from \"../types\";\n\nconst DEFAULT_VIRTUAL_FOLDER = \".xyd/.cache/.content\" // TODO: share this + .xyd/.build/.content for build\n\nconst DEFAULT_GROUP_NAME = \"API Reference\" // TODO: configurable\n\ntype GroupMap = {\n    [key: string]: {\n        __groups: GroupMap\n        pages: Set<string>\n    }\n}\n\nexport interface pluginNavigationOptions {\n    urlPrefix: string\n    defaultGroup?: string\n}\n\ntype pluginNavigationOutput = {\n    pageFrontMatter: MetadataMap;\n    sidebar: Sidebar[];\n}\n\nexport function pluginNavigation(\n    settings: Settings,\n    options: pluginNavigationOptions\n): UniformPlugin<pluginNavigationOutput> {\n    if (!options.urlPrefix) {\n        throw new Error(\"urlPrefix is required\")\n    }\n\n    return function pluginNavigationInner({\n        defer,\n    }: UniformPluginArgs) {\n        const pageFrontMatter: MetadataMap = {}\n        const groupMaps: GroupMap = {}\n\n        defer(() => ({\n            pageFrontMatter,\n            sidebar: convertGroupMapsToSidebar(settings, groupMaps) as Sidebar[]\n        }))\n\n        return (ref: Reference) => {\n            const dataCtx = ref.context\n            const pagePath = path.join(options.urlPrefix, ref.canonical)\n\n            let group = dataCtx?.group || []\n            let title = ref.title\n\n            if (pageFrontMatter[pagePath]) {\n                console.error(\"(pluginNavigation): pageFrontMatter[pagePath] already exists\", pagePath)\n            }\n\n            if (!group) {\n                group = [options.defaultGroup || DEFAULT_GROUP_NAME]\n            }\n\n            pageFrontMatter[pagePath] = {\n                title,\n            }\n\n            if (typeof group === \"string\") {\n                // TODO: seek nested group (it's not always from 0)\n                throw new Error(\"group as string is not supported yet\")\n            }\n\n            group.reduce((groups: GroupMap, groupName: string, i: number) => {\n                if (!groups[groupName]) {\n                    groups[groupName] = {\n                        __groups: {},\n                        pages: new Set()\n                    }\n                }\n\n                if (i === group.length - 1) {\n                    groups[groupName].pages.add(pagePath)\n                }\n\n                return groups[groupName].__groups\n            }, groupMaps)\n        }\n    }\n}\n\nfunction convertGroupMapsToSidebar(settings: Settings, groupMaps: GroupMap): Sidebar[] {\n    const nav: Sidebar[] = []\n\n    Object.keys(groupMaps).map((groupName) => {\n        const current = groupMaps[groupName]\n\n        const pages: PageURL[] = []\n\n        current.pages.forEach((page: string) => {\n            if (settings?.engine?.uniform?.store) {\n                pages.push(page)\n                return\n            }\n            pages.push({\n                virtual: path.join(DEFAULT_VIRTUAL_FOLDER, page),\n                page: page,\n            })\n        })\n\n        if (Object.keys(current.__groups).length) {\n            const subNav: Sidebar = {\n                group: groupName,\n                pages: convertGroupMapsToSidebar(settings, current.__groups)\n            }\n\n            nav.push(subNav)\n\n            return\n        }\n\n        nav.push({\n            group: groupName,\n            pages,\n        })\n    })\n\n    return nav\n}\n\n// TODO: in the future xyd settings must be removed cuz uniform will be part of opendocs\n// example usage:\n// const response = uniform([/* references */], {\n//     plugins: [pluginNavigation({}, {\n//         urlPrefix: \"/docs\"\n//     })],\n// });\n"],"mappings":"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","names":["DEFINED_DEFINITION_PROPERTY_TYPE","ReferenceCategory","ReferenceType","path"]}

package/dist/index.d.cts

@@ -0,0 +1,45 @@
+import { R as Reference } from './types-BiglsETJ.cjs';
+export { B as BaseReferenceContext, m as CodeBlock, n as CodeBlockTab, C as CommonDefinitionVariantMeta, i as DEFINED_DEFINITION_PROPERTY_TYPE, d as Definition, b as DefinitionGraphqlMeta, c as DefinitionMeta, D as DefinitionOpenAPIMeta, j as DefinitionProperty, h as DefinitionPropertyMeta, a as DefinitionTypeDocMeta, g as DefinitionVariant, f as DefinitionVariantMeta, e as DefinitionVariantOpenAPIMeta, l as Example, o as ExampleContext, k as ExampleGroup, E as ExampleRoot, t as GraphQLExampleContext, G as GraphQLReferenceContext, M as Meta, u as OpenAPIExampleContext, O as OpenAPIReferenceContext, p as ReferenceCategory, s as ReferenceContext, q as ReferenceType, S as SymbolDef, r as TypeDocReferenceContext, T as TypeDocReferenceContextMeta } from './types-BiglsETJ.cjs';
+import { Settings, MetadataMap, Sidebar } from '@xyd-js/core';
+import 'react';
+import 'codehike/code';
+
+type UniformPluginArgs = {
+    references: Reference[] | Reference;
+    defer: (defer: () => any) => void;
+};
+type UniformPluginRestArgs = {
+    index: number;
+};
+type UniformPlugin<T> = (args: UniformPluginArgs) => (ref: Reference, restArgs: UniformPluginRestArgs) => void;
+type NormalizeArray<T> = T extends Array<infer U> ? U[] : T;
+type PluginResult<T extends UniformPlugin<any>> = T extends UniformPlugin<infer R> ? R : never;
+type MergePluginResults<T extends UniformPlugin<any>[]> = {
+    [K in keyof UnionToIntersection<PluginResult<T[number]>>]: NormalizeArray<UnionToIntersection<PluginResult<T[number]>>[K]>;
+};
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+declare function uniform<T extends UniformPlugin<any>[]>(references: Reference[], config: {
+    plugins: T;
+}): {
+    references: Reference[];
+    out: MergePluginResults<T> extends infer T_1 ? { [K in keyof T_1]: MergePluginResults<T>[K]; } : never;
+};
+
+interface pluginJsonViewOptions {
+}
+type pluginJsonViewOutput = {
+    jsonViews: string;
+};
+declare function pluginJsonView(options?: pluginJsonViewOptions): UniformPlugin<pluginJsonViewOutput>;
+
+interface pluginNavigationOptions {
+    urlPrefix: string;
+    defaultGroup?: string;
+}
+type pluginNavigationOutput = {
+    pageFrontMatter: MetadataMap;
+    sidebar: Sidebar[];
+};
+declare function pluginNavigation(settings: Settings, options: pluginNavigationOptions): UniformPlugin<pluginNavigationOutput>;
+
+export { Reference, type UniformPlugin, type UniformPluginArgs, uniform as default, pluginJsonView, pluginNavigation };