@xyd-js/documan 0.1.0-xyd.0

package/host/node_modules/.vite/deps/unist-util-visit.js

@@ -0,0 +1,14 @@
+import {
+  CONTINUE,
+  EXIT,
+  SKIP,
+  visit
+} from "./chunk-O6QCC74R.js";
+import "./chunk-2TUXWMP5.js";
+export {
+  CONTINUE,
+  EXIT,
+  SKIP,
+  visit
+};
+//# sourceMappingURL=unist-util-visit.js.map

package/host/node_modules/.vite/deps/unist-util-visit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/host/node_modules/.vite/deps/vfile.js

@@ -0,0 +1,8 @@
+import {
+  VFile
+} from "./chunk-SBIFJFEH.js";
+import "./chunk-2TUXWMP5.js";
+export {
+  VFile
+};
+//# sourceMappingURL=vfile.js.map

package/host/node_modules/.vite/deps/vfile.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/host/package.json

@@ -0,0 +1,43 @@
+{
+  "private": true,
+  "name": "@xyd-js/documan-host",
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {},
+  "dependencies": {
+    "@xyd-js/atlas": "workspace:*",
+    "@xyd-js/core": "workspace:*",
+    "@xyd-js/content": "workspace:*",
+    "@xyd-js/framework": "workspace:*",
+    "@xyd-js/gql": "workspace:*",
+    "@xyd-js/openapi": "workspace:*",
+    "@xyd-js/uniform": "workspace:*",
+    "@xyd-js/theme-gusto": "workspace:*",
+    "@react-router/node": "^7.1.1",
+    "@react-router/serve": "^7.1.1",
+    "codehike": "^1.0.3",
+    "express": "^4.21.1",
+    "isbot": "^5.1.17",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router": "^7.1.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.0",
+    "remark-mdx-frontmatter": "^5.0.0",
+    "typescript": "^5.6.3",
+    "vfile": "^6.0.3",
+    "yaml": "^2.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.5",
+    "@types/react-dom": "^18.3.1",
+    "@mdx-js/rollup": "^3.1.0",
+    "@types/react": "^18.3.9",
+    "@vitejs/plugin-react": "^4.3.2",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.47",
+    "typescript": "^5.6.2",
+    "vite": "^5.4.9",
+    "vite-tsconfig-paths": "^5.0.1"
+  }
+}

package/host/postcss.config.cjs

@@ -0,0 +1,5 @@
+module.exports = {
+    plugins: {
+        autoprefixer: {},
+    },
+}

package/host/react-router.config.ts

@@ -0,0 +1,8 @@
+import type {Config} from "@react-router/dev/config";
+
+export default {
+    // return a list of URLs to prerender at build time
+    async prerender() {
+        return ["/example"];
+    },
+} satisfies Config;

package/host/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": [
+      "ES2020",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": false,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "jsx": "react-jsx"
+  }
+}

package/host/vite.config.ts

@@ -0,0 +1,9 @@
+import {defineConfig} from 'vite';
+
+// DO NOT DELETE
+// This file is needed for host `vite` to run
+export default defineConfig(async () => {
+    return {
+        plugins: [],
+    };
+});

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@xyd-js/documan",
+  "version": "0.1.0-xyd.0",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./dist/index.js",
+    "./dev": "./dist/dev.js",
+    "./build": "./dist/build.js",
+    "./serve": "./dist/serve.js"
+  },
+  "dependencies": {
+    "@xyd-js/react-router-dev": "7.1.1-xyd.3",
+    "@react-router/node": "^7.1.1",
+    "@react-router/serve": "^7.1.1",
+    "@react-router/dev": "^7.1.1",
+    "codehike": "^1.0.3",
+    "compression": "^1.7.5",
+    "express": "^4.21.2",
+    "get-port": "^7.1.0",
+    "gray-matter": "^4.0.3",
+    "isbot": "^5.1.17",
+    "lightningcss": "^1.27.0",
+    "morgan": "^1.10.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router": "^7.1.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.0",
+    "remark-mdx-frontmatter": "^5.0.0",
+    "source-map-support": "^0.5.21",
+    "typescript": "^5.6.3",
+    "vfile": "^6.0.3",
+    "yaml": "^2.6.0",
+    "@xyd-js/core": "0.1.0-xyd.0",
+    "@xyd-js/content": "0.1.0-xyd.2",
+    "@xyd-js/openapi": "0.1.0-xyd.0",
+    "@xyd-js/plugin-zero": "0.1.0-xyd.0",
+    "@xyd-js/gql": "0.1.0-xyd.0",
+    "@xyd-js/atlas": "0.1.0-xyd.1",
+    "@xyd-js/framework": "0.1.0-xyd.1",
+    "@xyd-js/theme-poetry": "0.1.0-xyd.1",
+    "@xyd-js/uniform": "0.1.0-xyd.2"
+  },
+  "devDependencies": {
+    "@mdx-js/rollup": "^3.1.0",
+    "@types/node": "^22.7.5",
+    "@types/react": "^18.3.9",
+    "@types/react-dom": "^18.3.1",
+    "@vitejs/plugin-react": "^4.3.2",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.47",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.2",
+    "vite": "^5.4.9",
+    "vite-tsconfig-paths": "^5.0.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:tsc": "tsc --project ./tsconfig.build.json",
+    "watch": "tsup --watch"
+  }
+}

package/src/commands/build.ts

@@ -0,0 +1,4 @@
+import {build} from "../"
+
+// Execute the build function
+await build();

package/src/commands/dev.ts

@@ -0,0 +1,5 @@
+import {dev} from "../"
+
+// Execute the dev function
+await dev();
+

package/src/commands/serve.ts

@@ -0,0 +1,5 @@
+import {serve} from "../"
+
+// Execute the serve function
+await serve();
+

package/src/index.ts

@@ -0,0 +1,7 @@
+export {
+    build,
+
+    dev,
+
+    serve
+} from "./run"

package/src/run/build.ts

@@ -0,0 +1,98 @@
+import path from "node:path";
+import fs from "node:fs";
+import {fileURLToPath} from "node:url";
+
+import {build as viteBuild} from 'vite';
+import tsconfigPaths from "vite-tsconfig-paths";
+
+import {reactRouter} from "@xyd-js/react-router-dev/vite";
+// import { reactRouter } from "@react-router/dev/vite";
+
+import {vitePlugins as xydContentVitePlugins} from "@xyd-js/content"
+import {pluginZero} from "@xyd-js/plugin-zero";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Define the main function to run the builds
+export async function build() {
+    const resp = await pluginZero()
+    if (!resp) {
+        throw new Error("PluginZero not found")
+    }
+
+    const buildDir = path.join(process.cwd(), ".xyd/build");
+
+    {
+        const packageJsonPath = path.join(buildDir, 'package.json');
+
+        const packageJsonContent = {
+            type: "module",
+            scripts: {},
+            dependencies: {},
+            devDependencies: {}
+        };
+
+        // Ensure the build directory exists
+        if (!fs.existsSync(buildDir)) {
+            fs.mkdirSync(buildDir, {recursive: true});
+        }
+
+        // Write the package.json file
+        fs.writeFileSync(packageJsonPath, JSON.stringify(packageJsonContent, null, 2), 'utf8');
+    }
+
+    try {
+        // Build the client-side bundle
+        await viteBuild({
+            root: path.join(__dirname, "../host"),
+            // @ts-ignore
+            plugins: [
+                ...(xydContentVitePlugins({
+                    toc: {
+                        minDepth: 2,
+                    }
+                }) as Plugin[]),
+                reactRouter({
+                    outDir: buildDir,
+                    routes: resp.routes
+                }),
+                tsconfigPaths(),
+                ...resp.vitePlugins
+            ],
+            optimizeDeps: {
+                include: ["react/jsx-runtime"],
+            },
+        });
+
+        // Build the SSR bundle
+        await viteBuild({
+            root: path.join(__dirname, "../host"),
+            build: {
+                ssr: true,
+            },
+            // @ts-ignore
+            plugins: [
+                ...(xydContentVitePlugins({
+                    toc: {
+                        minDepth: 2,
+                    }
+                }) as Plugin[]),
+                reactRouter({
+                    outDir: buildDir,
+                    routes: resp.routes
+                }),
+                tsconfigPaths(),
+                ...resp.vitePlugins
+            ],
+            optimizeDeps: {
+                include: ["react/jsx-runtime"],
+            },
+        });
+
+        console.log('Build completed successfully.'); // TODO: better message
+    } catch (error) {
+        console.error('Build failed:', error);  // TODO: better message
+    }
+}
+

package/src/run/dev.ts

@@ -0,0 +1,76 @@
+import path from "node:path";
+import {fileURLToPath} from "node:url";
+import {createServer, searchForWorkspaceRoot} from "vite";
+
+import {reactRouter} from "@xyd-js/react-router-dev/vite";
+// import { reactRouter } from "@react-router/dev/vite";
+
+import {vitePlugins as xydContentVitePlugins} from "@xyd-js/content";
+import {pluginZero} from "@xyd-js/plugin-zero";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const port = process.env.XYD_PORT ? parseInt(process.env.XYD_PORT) : 5175;
+
+export async function dev() {
+    const resp = await pluginZero()
+    if (!resp) {
+        throw new Error("PluginZero not found")
+    }
+
+    const allowCwd = searchForWorkspaceRoot(process.cwd())
+
+    const preview = await createServer({
+        // any valid user config options, plus `mode` and `configFile`
+        // configFile: path.join(__dirname, "../src/vite/empty-config.ts"), // TODO: bundler??
+        // configFile: path.join(__dirname, "../"), // TODO: bundler??
+        // root: path.join(__dirname, "../"), // TODO: bundler?
+        root: process.env.XYD_DOCUMAN_HOST || path.join(__dirname, "../host"), // TODO: bundler?
+        server: {
+            port: port,
+            fs: {
+                allow: [
+                    allowCwd,
+                    process.env.XYD_CLI ? path.join(__dirname, "../../") : "",
+                    // path.join(__dirname, "../node_modules") // Ensure node_modules from xyd-documan is included
+                ]
+            }
+        },
+        build: {
+            rollupOptions: {
+                // Exclude package `B` from the client-side bundle
+                external: ["@xyd-js/uniform", "@xyd-js/uniform/content", "@xyd-js/plugin-zero"],
+            },
+        },
+        ssr: {
+            external: ["@xyd-js/uniform", "@xyd-js/uniform/content", "@xyd-js/plugin-zero"],
+            // noExternal: [
+            //     "@xyd-js/uniform",
+            //     "@xyd-js/uniform/content",
+            //     "@xyd-js/plugin-zero"
+            // ],
+        },
+        optimizeDeps: {
+            include: ["react/jsx-runtime"],
+        },
+        // @ts-ignore
+        plugins: [ // TODO: fix plugin ts
+            ...(xydContentVitePlugins({
+                toc: {
+                    minDepth: 2,
+                }
+            }) as Plugin[]),
+            reactRouter({
+                routes: resp.routes
+            }),
+            ...resp.vitePlugins
+        ],
+    });
+
+    await preview.listen(port);
+
+    preview.printUrls();
+    preview.bindCLIShortcuts({print: true});
+
+}

package/src/run/index.ts

@@ -0,0 +1,6 @@
+export {build} from "./build"
+
+export {dev} from "./dev"
+
+export {serve} from "./serve"
+

package/src/run/serve.ts

@@ -0,0 +1,106 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import url from "node:url";
+
+import type {ServerBuild} from "react-router";
+import {createRequestHandler} from "@react-router/express";
+import compression from "compression";
+import express from "express";
+import morgan from "morgan";
+import sourceMapSupport from "source-map-support";
+import getPort from "get-port";
+
+function parseNumber(raw?: string) {
+    if (raw === undefined) return undefined;
+    let maybe = Number(raw);
+    if (Number.isNaN(maybe)) return undefined;
+    return maybe;
+}
+
+export async function serve() {
+    process.env.NODE_ENV = process.env.NODE_ENV ?? "production";
+
+    sourceMapSupport.install({
+        retrieveSourceMap: function (source) {
+            let match = source.startsWith("file://");
+            if (match) {
+                let filePath = url.fileURLToPath(source);
+                let sourceMapPath = `${filePath}.map`;
+                if (fs.existsSync(sourceMapPath)) {
+                    return {
+                        url: source,
+                        map: fs.readFileSync(sourceMapPath, "utf8"),
+                    };
+                }
+            }
+            return null;
+        },
+    });
+
+    let port = parseNumber(process.env.PORT) ?? (await getPort({port: 3000}));
+
+    let buildPathArg = path.join(process.cwd(), ".xyd/build/server/index.js")
+
+    if (!buildPathArg) {
+        console.error(`
+  Usage: react-router-serve <server-build-path> - e.g. react-router-serve build/server/index.js`);
+        process.exit(1);
+    }
+
+    let buildPath = path.resolve(buildPathArg);
+
+    let build: ServerBuild = await import(url.pathToFileURL(buildPath).href);
+
+    let onListen = () => {
+        let address =
+            process.env.HOST ||
+            Object.values(os.networkInterfaces())
+                .flat()
+                .find((ip) => String(ip?.family).includes("4") && !ip?.internal)
+                ?.address;
+
+        if (!address) {
+            console.log(`[xyd-serve] http://localhost:${port}`);
+        } else {
+            console.log(
+                `[xyd-serve] http://localhost:${port} (http://${address}:${port})`
+            );
+        }
+    };
+
+    build = {
+        ...build,
+        assetsBuildDirectory: path.join(process.cwd(), ".xyd/build/client")
+    }
+
+    let app = express();
+    app.disable("x-powered-by");
+    app.use(compression());
+    app.use(
+        path.posix.join(build.publicPath, "assets"),
+        express.static(path.join(build.assetsBuildDirectory, "assets"), {
+            immutable: true,
+            maxAge: "1y",
+        })
+    );
+    app.use(build.publicPath, express.static(build.assetsBuildDirectory));
+    app.use(express.static("public", {maxAge: "1h"}));
+    app.use(morgan("tiny"));
+
+    app.all(
+        "*",
+        createRequestHandler({
+            build,
+            mode: process.env.NODE_ENV,
+        })
+    );
+
+    let server = process.env.HOST
+        ? app.listen(port, process.env.HOST, onListen)
+        : app.listen(port, onListen);
+
+    ["SIGTERM", "SIGINT"].forEach((signal) => {
+        process.once(signal, () => server?.close(console.error));
+    });
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "module": "esnext",
+    "esModuleInterop": true,
+    "moduleResolution": "bundler",
+    "target": "esnext", // Change this to es2020 or esnext
+    "baseUrl": ".",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "noEmit": true,
+    "incremental": false,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "plugins": [],
+    "strictNullChecks": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "host/**/*.ts", "host/**/*.tsx"],
+  "exclude": ["node_modules"]
+}

package/tsup.config.ts

@@ -0,0 +1,81 @@
+import {defineConfig} from 'tsup';
+import pkg from './package.json';
+
+const deps = [
+    ...Object.keys(pkg.dependencies || {}),
+    ...Object.keys(pkg.devDependencies || {}),
+].filter((dep) => [
+    "@xyd-js/core",
+    "@xyd-js/content",
+    "@xyd-js/framework",
+    "@xyd-js/ui",
+    "@xyd-js/openapi",
+    "@xyd-js/uniform",
+    "@xyd-js/theme-gusto",
+    // "@xyd-js/plugin-zero", // TODO: because plugin-zero has react-router dependency
+].indexOf(dep) === -1)
+
+export default defineConfig({
+    entry: {
+        index: 'src/index.ts',
+        dev: 'src/commands/dev.ts',
+        build: 'src/commands/build.ts',
+        serve: 'src/commands/serve.ts',
+    },
+    dts: {
+        entry: {
+            index: 'src/index.ts',
+            dev: 'src/commands/dev.ts',
+            build: 'src/commands/build.ts',
+            serve: 'src/commands/serve.ts',
+        },
+        resolve: true, // Resolve external types
+    },
+
+    format: ["esm"],
+    platform: 'node',
+    shims: false,
+    splitting: false,
+    sourcemap: true,
+    clean: true,
+    bundle: true, // Enable bundling
+    external: [
+        ...deps,
+
+        // needed by @xyd-js/plugin-zero
+        "react-router",
+        "@react-router/dev",
+        "@react-router/express",
+
+        "@xyd-js/react-router-dev",
+
+        "@readme/json-schema-ref-parser",
+        "@apidevtools/json-schema-ref-parser",
+        //
+
+        //
+        // Externalize Node.js built-in modules
+        /^node:.*/,
+        'fs',
+        'path',
+        'url',
+        'os',
+        'http',
+        'https',
+        'stream',
+        'zlib',
+        'util',
+        'crypto',
+        'tty',
+
+        // "lightningcss",
+        // "vite",
+        // "vite-tsconfig-paths",
+        // "react-router",
+        // "@react-router/serve",
+        // "@react-router/dev",
+        // "@xydjs/react-router-dev",
+        // "@mdx-js/rollup",
+        // "@graphql-markdown"
+    ], // Ensure no dependencies are marked as external
+})