pi-harness-runtime 0.9.2 → 0.9.5

package/packages/frappe-plugin/test/analyzer.test.ts

@@ -0,0 +1,250 @@
+/**
+ * Frappe Plugin Tests (RFC-0061)
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "bun:test";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { analyzeFrappe } from "../src/analyzer.js";
+
+const tempRoots: string[] = [];
+
+async function mkdtemp(): Promise<string> {
+	const dir = await fs.mkdtemp(path.join(os.tmpdir(), "frappe-plugin-"));
+	tempRoots.push(dir);
+	return dir;
+}
+
+afterEach(async () => {
+	for (const dir of tempRoots) {
+		try {
+			await fs.rm(dir, { recursive: true, force: true });
+		} catch {
+			// ignore
+		}
+	}
+	tempRoots.length = 0;
+});
+
+describe("analyzeFrappe", () => {
+	it("returns null for non-frappe workspace", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(path.join(dir, "package.json"), "{}", "utf-8");
+		const result = await analyzeFrappe(dir);
+		expect(result).toBeNull();
+	});
+
+	it("detects frappe workspace via sites directory", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "sites"), { recursive: true });
+		const result = await analyzeFrappe(dir);
+		expect(result).not.toBeNull();
+		expect(["frappe", "erpnext"]).toContain(result!.framework.id);
+	});
+
+	it("detects frappe workspace via apps.txt", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, "apps.txt"),
+			"frappe\nerpnext\n",
+			"utf-8",
+		);
+		const result = await analyzeFrappe(dir);
+		expect(result).not.toBeNull();
+	});
+
+	it("parses apps from apps.txt", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "apps"), { recursive: true });
+		await fs.writeFile(
+			path.join(dir, "apps.txt"),
+			"frappe\nerpnext\nmy_custom_app\n",
+			"utf-8",
+		);
+		await fs.mkdir(path.join(dir, "apps", "frappe"), { recursive: true });
+		await fs.mkdir(path.join(dir, "apps", "erpnext"), { recursive: true });
+		await fs.mkdir(path.join(dir, "apps", "my_custom_app"), {
+			recursive: true,
+		});
+		const result = await analyzeFrappe(dir);
+		expect(result).not.toBeNull();
+		const appNames = result!.apps.map((a) => a.name);
+		expect(appNames).toContain("frappe");
+		expect(appNames).toContain("erpnext");
+	});
+
+	it("parses hooks.py to extract app_name and __version__", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "apps", "myapp", "myapp"), {
+			recursive: true,
+		});
+		await fs.writeFile(path.join(dir, "apps.txt"), "myapp\n", "utf-8");
+		await fs.writeFile(
+			path.join(dir, "apps", "myapp", "myapp", "hooks.py"),
+			`
+app_name = "myapp"
+app_title = "My App"
+app_publisher = "Test"
+__version__ = "1.2.3"
+docevents = {
+    "DocType": ["validate", "on_update"],
+}
+`.trim(),
+			"utf-8",
+		);
+
+		const result = await analyzeFrappe(dir);
+		expect(result).not.toBeNull();
+		const myAppHooks = result!.hooks.find((h) => h.appName === "myapp");
+		expect(myAppHooks).toBeDefined();
+		expect(myAppHooks!.hooks["app_name"]).toContain("myapp");
+		expect(myAppHooks!.hooks["docevents"]).toBeDefined();
+
+		const myApp = result!.apps.find((a) => a.name === "myapp");
+		expect(myApp?.version).toBe("1.2.3");
+	});
+
+	it("detects ERPNext from package.json dependencies", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "apps", "erpnext", "erpnext"), {
+			recursive: true,
+		});
+		await fs.mkdir(path.join(dir, "apps", "frappe", "frappe"), {
+			recursive: true,
+		});
+		await fs.writeFile(
+			path.join(dir, "apps.txt"),
+			"frappe\nerpnext\n",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "apps", "erpnext", "package.json"),
+			JSON.stringify({
+				name: "erpnext",
+				version: "14.0.0",
+				dependencies: { frappe: "^14.0.0", erpnext: "^14.0.0" },
+			}),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "apps", "erpnext", "erpnext", "hooks.py"),
+			"app_name = 'erpnext'\n",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "apps", "frappe", "frappe", "hooks.py"),
+			"app_name = 'frappe'\n",
+			"utf-8",
+		);
+
+		const result = await analyzeFrappe(dir);
+		expect(result!.isErpNext).toBe(true);
+		expect(result!.framework.id).toBe("erpnext");
+	});
+
+	it("scans sites directory", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "sites", "site1.local"), { recursive: true });
+		await fs.mkdir(path.join(dir, "sites", "site2.local"), { recursive: true });
+		await fs.writeFile(
+			path.join(dir, "sites", "site1.local", "site_config.json"),
+			JSON.stringify({ db_port: 3306 }),
+			"utf-8",
+		);
+
+		const result = await analyzeFrappe(dir);
+		expect(result!.sites.length).toBe(2);
+		const site1 = result!.sites.find((s) => s.name === "site1.local");
+		expect(site1!.dbPort).toBe(3306);
+		expect(site1!.hasSiteConfig).toBe(true);
+	});
+
+	it("counts DocTypes in app module directory", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(
+			path.join(dir, "apps", "myapp", "myapp", "doctype", "customer"),
+			{ recursive: true },
+		);
+		await fs.mkdir(
+			path.join(dir, "apps", "myapp", "myapp", "doctype", "order"),
+			{ recursive: true },
+		);
+		await fs.mkdir(
+			path.join(dir, "apps", "myapp", "myapp", "doctype", "custom_so"),
+			{ recursive: true },
+		);
+		await fs.writeFile(path.join(dir, "apps.txt"), "myapp\n", "utf-8");
+		await fs.writeFile(
+			path.join(dir, "apps", "myapp", "myapp", "hooks.py"),
+			"app_name = 'myapp'\n",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(
+				dir,
+				"apps",
+				"myapp",
+				"myapp",
+				"doctype",
+				"customer",
+				"customer.json",
+			),
+			JSON.stringify({
+				doctype: "DocType",
+				name: "Customer",
+				fields: [{ fieldname: "customer_name" }, { fieldname: "email" }],
+			}),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(
+				dir,
+				"apps",
+				"myapp",
+				"myapp",
+				"doctype",
+				"order",
+				"order.json",
+			),
+			JSON.stringify({
+				doctype: "DocType",
+				name: "Sales Order",
+				is_submittable: 1,
+				fields: Array(5).fill({}),
+			}),
+			"utf-8",
+		);
+
+		const result = await analyzeFrappe(dir);
+		expect(
+			result!.apps.find((a) => a.name === "myapp")!.doctypeCount,
+		).toBeGreaterThanOrEqual(2);
+		const customerDt = result!.doctypes.find((d) => d.name === "customer");
+		expect(customerDt).toBeDefined();
+		expect(customerDt!.nFields).toBe(2);
+		const orderDt = result!.doctypes.find((d) => d.name === "order");
+		expect(orderDt!.isSubmittable).toBe(true);
+	});
+
+	it("detects Frappe SPA from package.json", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "apps", "frappe", "frappe"), {
+			recursive: true,
+		});
+		await fs.writeFile(path.join(dir, "apps.txt"), "frappe\n", "utf-8");
+		await fs.writeFile(
+			path.join(dir, "apps", "frappe", "package.json"),
+			JSON.stringify({ dependencies: { "@frappe/ui": "^1.0.0" } }),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "apps", "frappe", "frappe", "hooks.py"),
+			"app_name = 'frappe'\n",
+			"utf-8",
+		);
+
+		const result = await analyzeFrappe(dir);
+		expect(result!.hasSPA).toBe(true);
+	});
+});

package/packages/frappe-plugin/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "references": [
+    { "path": "../framework-plugin-sdk" },
+    { "path": "../framework-detector" }
+  ]
+}

package/packages/generic-web-plugin/dist/analyzer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generic Web Plugin — Analyzer (RFC-0066)
+ *
+ * Detects and deeply analyzes generic web projects.
+ */
+import type { GenericWebAnalysis } from "./types.js";
+/**
+ * Detect if a directory is a generic web project
+ */
+export declare function detectWeb(root: string): Promise<boolean>;
+/**
+ * Deep analysis of a generic web project
+ */
+export declare function analyzeWeb(root: string): Promise<GenericWebAnalysis | null>;
+//# sourceMappingURL=analyzer.d.ts.map

package/packages/generic-web-plugin/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACX,kBAAkB,EAIlB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9D;AAuSD;;GAEG;AACH,wBAAsB,UAAU,CAC/B,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgBpC"}

package/packages/generic-web-plugin/dist/analyzer.js

@@ -0,0 +1,310 @@
+/**
+ * Generic Web Plugin — Analyzer (RFC-0066)
+ *
+ * Detects and deeply analyzes generic web projects.
+ */
+import { existsSync } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+// ─── Detection ────────────────────────────────────────────────────────────────
+/**
+ * Detect if a directory is a generic web project
+ */
+export async function detectWeb(root) {
+    const hasPackageJson = existsSync(join(root, "package.json"));
+    const hasNodeModules = existsSync(join(root, "node_modules"));
+    const hasSrc = existsSync(join(root, "src")) ||
+        existsSync(join(root, "app")) ||
+        existsSync(join(root, "pages")) ||
+        existsSync(join(root, "components"));
+    return hasPackageJson && (hasNodeModules || hasSrc);
+}
+// ─── Framework Detection ────────────────────────────────────────────────────
+async function detectFramework(root) {
+    const pkgJson = await readFile(join(root, "package.json"), "utf-8").catch(() => "{}");
+    const pkg = JSON.parse(pkgJson);
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const scripts = pkg.scripts || {};
+    if (deps["next"])
+        return "next";
+    if (deps["@remix-run/react"])
+        return "remix";
+    if (deps["astro"])
+        return "astro";
+    if (deps["nuxt"])
+        return "nuxt";
+    if (deps["svelte"])
+        return "svelte";
+    if (deps["vite"] && deps["react"])
+        return "react-vite";
+    if (deps["vite"] && deps["vue"])
+        return "vue-vite";
+    if (deps["webpack"])
+        return "webpack";
+    if (deps["express"])
+        return "express";
+    if (deps["fastify"])
+        return "fastify";
+    if (deps["koa"])
+        return "koa";
+    if (deps["hono"])
+        return "hono";
+    if (deps["flask"])
+        return "flask";
+    if (deps["django"])
+        return "django";
+    if (deps["rails"] || deps["@rails/ujs"])
+        return "rails";
+    if (deps["laravel-mix"] || deps["laravel"])
+        return "laravel";
+    if (scripts["nuxt"] || scripts["nuxt:build"])
+        return "nuxt";
+    if (scripts["astro"] || scripts["astro:build"])
+        return "astro";
+    return "static";
+}
+// ─── Route Scanning ─────────────────────────────────────────────────────────
+async function findRouteFiles(root, framework) {
+    const routes = [];
+    const patterns = getRoutePatterns(framework);
+    for (const { dir, exts } of patterns) {
+        const fullDir = join(root, dir);
+        if (!existsSync(fullDir))
+            continue;
+        await scanDir(fullDir, fullDir, exts, (filePath, relPath) => {
+            const path = relPath
+                .replace(/\\/g, "/")
+                .replace(new RegExp(`\\${exts[0]}$`), "")
+                .replace(/\/index$/, "")
+                .replace(/^\//, "");
+            const route = {
+                path: path || "/",
+                file: filePath,
+                component: guessComponentName(framework, path),
+            };
+            routes.push(route);
+        });
+    }
+    return deduplicateRoutes(routes);
+}
+function getRoutePatterns(framework) {
+    switch (framework) {
+        case "next":
+            return [
+                { dir: "pages", exts: [".tsx", ".jsx", ".ts", ".js"] },
+                { dir: "app", exts: [".tsx", ".jsx"] },
+            ];
+        case "nuxt":
+        case "remix":
+        case "astro":
+            return [{ dir: "app", exts: [".tsx", ".jsx", ".svelte", ".vue"] }];
+        case "react-vite":
+        case "vue-vite":
+        case "svelte":
+        case "static":
+        default:
+            return [
+                { dir: "src", exts: [".tsx", ".jsx", ".svelte", ".vue"] },
+                { dir: "components", exts: [".tsx", ".jsx", ".svelte", ".vue"] },
+                { dir: "pages", exts: [".tsx", ".jsx"] },
+            ];
+        case "express":
+        case "fastify":
+        case "koa":
+        case "hono":
+            return [{ dir: "routes", exts: [".ts", ".js"] }];
+        case "django":
+            return [
+                { dir: "templates", exts: [".html"] },
+                { dir: "views", exts: [".py"] },
+            ];
+        case "flask":
+            return [
+                { dir: "templates", exts: [".html"] },
+                { dir: "routes", exts: [".py"] },
+            ];
+        case "rails":
+            return [
+                { dir: "app/views", exts: [".html.erb", ".html.slim", ".html.haml"] },
+                { dir: "app/controllers", exts: [".rb"] },
+            ];
+        case "laravel":
+            return [
+                { dir: "resources/views", exts: [".blade.php", ".php"] },
+                { dir: "routes", exts: [".php"] },
+            ];
+    }
+}
+async function scanDir(dir, base, exts, emit) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith(".") || entry.name.startsWith("_"))
+            continue;
+        const fullPath = join(dir, entry.name);
+        const relPath = join(base, entry.name)
+            .slice(join(base, "").length)
+            .replace(/^[/\\]/, "");
+        if (entry.isDirectory()) {
+            await scanDir(fullPath, base, exts, emit);
+        }
+        else if (exts.includes(extname(entry.name))) {
+            emit(fullPath, relPath);
+        }
+    }
+}
+function guessComponentName(framework, path) {
+    const name = path.split("/").pop() || "index";
+    switch (framework) {
+        case "react-vite":
+            return `${name.charAt(0).toUpperCase()}${name.slice(1)}.tsx`;
+        case "vue-vite":
+            return `${name.charAt(0).toUpperCase()}${name.slice(1)}.vue`;
+        case "svelte":
+            return `${name.charAt(0).toUpperCase()}${name.slice(1)}.svelte`;
+        case "next":
+        case "nuxt":
+        case "remix":
+            return path.replace(/\//g, "-").replace(/^-/, "") || "home";
+        default:
+            return name;
+    }
+}
+function deduplicateRoutes(routes) {
+    const seen = new Set();
+    const result = [];
+    for (const route of routes) {
+        if (!seen.has(route.path)) {
+            seen.add(route.path);
+            result.push(route);
+        }
+    }
+    return result;
+}
+// ─── API Endpoint Detection ──────────────────────────────────────────────────
+async function findApiEndpoints(root, framework) {
+    if (![
+        "express",
+        "fastify",
+        "koa",
+        "hono",
+        "flask",
+        "django",
+        "rails",
+        "laravel",
+        "next",
+    ].includes(framework)) {
+        return [];
+    }
+    const endpoints = [];
+    const patterns = getApiPatterns(framework);
+    for (const { dir, exts } of patterns) {
+        const fullDir = join(root, dir);
+        if (!existsSync(fullDir))
+            continue;
+        await scanDir(fullDir, fullDir, exts, (filePath, relPath) => {
+            const methods = extractHttpMethods(filePath);
+            const routePath = relPath
+                .replace(/\\/g, "/")
+                .replace(new RegExp(`\\${exts[0]}$`), "")
+                .replace(/\/index$/, "")
+                .replace(/^api\//, "")
+                .replace(/^routes\//, "");
+            for (const method of methods) {
+                endpoints.push({
+                    method,
+                    path: `/${routePath}`,
+                    file: filePath,
+                });
+            }
+        });
+    }
+    return endpoints;
+}
+function getApiPatterns(framework) {
+    switch (framework) {
+        case "express":
+        case "fastify":
+        case "koa":
+        case "hono":
+            return [
+                { dir: "routes", exts: [".ts", ".js"] },
+                { dir: "src/routes", exts: [".ts", ".js"] },
+            ];
+        case "next":
+            return [
+                { dir: "pages/api", exts: [".ts", ".js"] },
+                { dir: "app/api", exts: [".ts", ".tsx"] },
+            ];
+        case "flask":
+            return [
+                { dir: "routes", exts: [".py"] },
+                { dir: "app", exts: [".py"] },
+            ];
+        case "django":
+            return [
+                { dir: "views", exts: [".py"] },
+                { dir: "api", exts: [".py"] },
+            ];
+        case "rails":
+            return [
+                { dir: "config/routes.rb", exts: [".rb"] },
+                { dir: "app/controllers", exts: [".rb"] },
+            ];
+        case "laravel":
+            return [
+                { dir: "routes", exts: [".php"] },
+                { dir: "app/Http/Controllers", exts: [".php"] },
+            ];
+        default:
+            return [];
+    }
+}
+function extractHttpMethods(filePath) {
+    try {
+        const content = require("fs").readFileSync(filePath, "utf-8");
+        const methods = new Set();
+        if (/\bget\b/i.test(content))
+            methods.add("GET");
+        if (/\bpost\b/i.test(content))
+            methods.add("POST");
+        if (/\bput\b/i.test(content))
+            methods.add("PUT");
+        if (/\bpatch\b/i.test(content))
+            methods.add("PATCH");
+        if (/\bdelete\b/i.test(content))
+            methods.add("DELETE");
+        if (/\boptions\b/i.test(content))
+            methods.add("OPTIONS");
+        return methods.size > 0 ? Array.from(methods) : ["GET"];
+    }
+    catch {
+        return ["GET"];
+    }
+}
+// ─── Analysis ────────────────────────────────────────────────────────────────
+/**
+ * Deep analysis of a generic web project
+ */
+export async function analyzeWeb(root) {
+    const detected = await detectWeb(root);
+    if (!detected)
+        return null;
+    const framework = await detectFramework(root);
+    const [routes, endpoints] = await Promise.all([
+        findRouteFiles(root, framework),
+        findApiEndpoints(root, framework),
+    ]);
+    return {
+        framework,
+        routes,
+        endpoints,
+        ssr: framework !== "static",
+    };
+}
+//# sourceMappingURL=analyzer.js.map

package/packages/generic-web-plugin/dist/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"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"}

package/packages/generic-web-plugin/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generic Web Plugin — Main Entry (RFC-0066)
+ */
+import type { FrameworkExtension } from "../../framework-plugin-sdk/src/types.js";
+export type { GenericWebAnalysis, WebFrameworkType, PageRoute, ApiEndpoint, } from "./types.js";
+/**
+ * Analyze a generic web project (RFC-0066)
+ */
+export declare function analyzeWebWorkspace(workspaceRoot: string): Promise<import("./types.js").GenericWebAnalysis | null>;
+/**
+ * Generic Web Framework Plugin (RFC-0066)
+ *
+ * Detects and deeply analyzes generic web frameworks:
+ * - Framework type detection (Next.js, Nuxt, Remix, Astro, Express, Fastify, etc.)
+ * - Route file discovery (pages, app/, components)
+ * - API endpoint scanning (routes/, pages/api/, controllers)
+ * - SSR/static detection
+ */
+export declare function createGenericWebPlugin(): FrameworkExtension;
+//# sourceMappingURL=index.d.ts.map

package/packages/generic-web-plugin/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAGlF,YAAY,EACX,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,aAAa,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,CA4B3D"}

package/packages/generic-web-plugin/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * Generic Web Plugin — Main Entry (RFC-0066)
+ */
+import { analyzeWeb } from "./analyzer.js";
+/**
+ * Analyze a generic web project (RFC-0066)
+ */
+export async function analyzeWebWorkspace(workspaceRoot) {
+    return analyzeWeb(workspaceRoot);
+}
+/**
+ * Generic Web Framework Plugin (RFC-0066)
+ *
+ * Detects and deeply analyzes generic web frameworks:
+ * - Framework type detection (Next.js, Nuxt, Remix, Astro, Express, Fastify, etc.)
+ * - Route file discovery (pages, app/, components)
+ * - API endpoint scanning (routes/, pages/api/, controllers)
+ * - SSR/static detection
+ */
+export function createGenericWebPlugin() {
+    return {
+        capability: "framework",
+        name: "Generic Web Framework Plugin",
+        detector: {
+            detect: async (workspaceRoot) => {
+                const root = workspaceRoot;
+                const { existsSync } = await import("node:fs");
+                return (existsSync(`${root}/package.json`) ||
+                    existsSync(`${root}/pages`) ||
+                    existsSync(`${root}/app`) ||
+                    existsSync(`${root}/src`) ||
+                    existsSync(`${root}/routes`) ||
+                    existsSync(`${root}/manage.py`) ||
+                    existsSync(`${root}/composer.json`));
+            },
+            signals: [
+                { type: "package", pattern: "package.json", weight: 0.5 },
+                { type: "directory", pattern: "src", weight: 0.4 },
+                { type: "directory", pattern: "pages", weight: 0.4 },
+                { type: "directory", pattern: "app", weight: 0.3 },
+                { type: "file", pattern: "routes", weight: 0.3 },
+            ],
+        },
+        config: {},
+    };
+}
+//# sourceMappingURL=index.js.map