@vaadin/hilla-file-router 24.4.0-alpha4

package/.lintstagedrc.js

@@ -0,0 +1,6 @@
+import { commands, extensions } from '../../../.lintstagedrc.js';
+
+export default {
+  [`src/**/*.{${extensions}}`]: commands,
+  [`test/**/*.{${extensions}}`]: commands,
+};

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@vaadin/hilla-file-router",
+  "version": "24.4.0-alpha4",
+  "description": "Hilla file-based router",
+  "main": "index.js",
+  "module": "index.js",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vaadin/hilla.git",
+    "directory": "packages/ts/hilla-file-router"
+  },
+  "keywords": [
+    "Hilla",
+    "Vite",
+    "Plugin",
+    "File",
+    "Router",
+    "Routing"
+  ],
+  "scripts": {
+    "clean:build": "git clean -fx . -e .vite -e node_modules",
+    "build": "concurrently npm:build:*",
+    "build:esbuild": "tsx ../../../scripts/build.ts",
+    "build:dts": "tsc --isolatedModules -p tsconfig.build.json",
+    "build:copy": "cd src && copyfiles **/*.d.ts ..",
+    "lint": "eslint src test",
+    "lint:fix": "eslint src test --fix",
+    "test": "mocha test/**/*.spec.ts --config ../../../.mocharc.cjs",
+    "test:coverage": "c8 -c ../../../.c8rc.json npm test",
+    "typecheck": "tsc --noEmit"
+  },
+  "exports": {
+    "./runtime.js": {
+      "default": "./runtime.js"
+    },
+    "./vite-plugin-file-router.js": {
+      "default": "./vite-plugin-file-router.js"
+    }
+  },
+  "author": "Vaadin Ltd",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/vaadin/hilla/issues"
+  },
+  "homepage": "https://vaadin.com",
+  "files": [
+    "*.{d.ts.map,d.ts,js.map,js}",
+    "runtime",
+    "vite-plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react-router": "^6.21.1"
+  },
+  "devDependencies": {
+    "@esm-bundle/chai": "^4.3.4-fix.0",
+    "@types/chai-like": "^1.1.3",
+    "@types/deep-equal-in-any-order": "^1.0.3",
+    "@types/mocha": "^10.0.6",
+    "@types/sinon": "^17.0.3",
+    "chai-like": "^1.1.1",
+    "deep-equal-in-any-order": "^2.0.6",
+    "mocha": "^10.2.0",
+    "rimraf": "^5.0.5",
+    "sinon": "^17.0.1",
+    "type-fest": "^4.9.0",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "@vaadin/hilla-generator-utils": "24.4.0-alpha4",
+    "react": "^18.2.0"
+  }
+}

package/runtime/utils.d.ts

@@ -0,0 +1,58 @@
+export type ViewConfig = Readonly<{
+    /**
+     * View title used in the main layout header, as <title> and as the default
+     * for the menu entry. If not defined, then the view function name is converted
+     * from CamelCase after removing any "View" postfix.
+     */
+    title?: string;
+    /**
+     * Same as in the explicit React Router configuration.
+     */
+    rolesAllowed?: string[];
+    /**
+     * Allows overriding the route path configuration. Uses the same syntax as
+     * the path property with React Router. This can be used to define a route
+     * that conflicts with the file name conventions, e.g. /foo/index
+     */
+    route?: string;
+    /**
+     * Controls whether the view implementation will be lazy loaded the first time
+     * it's used or always included in the bundle. If set to undefined (which is
+     * the default), views mapped to / and /login will be eager and any other view
+     * will be lazy (this is in sync with defaults in Flow)
+     */
+    lazy?: boolean;
+    /**
+     * If set to false, then the route will not be registered with React Router,
+     * but it will still be included in the main menu and used to configure
+     * Spring Security
+     */
+    register?: boolean;
+    menu?: Readonly<{
+        /**
+         * Title to use in the menu. Falls back the title property of the view
+         * itself if not defined.
+         */
+        title?: string;
+        /**
+         * Used to determine the order in the menu. Ties are resolved based on the
+         * used title. Entries without explicitly defined ordering are put below
+         * entries with an order.
+         */
+        order?: number;
+        /**
+         * Set to true to explicitly exclude a view from the automatically
+         * populated menu.
+         */
+        exclude?: boolean;
+    }>;
+}>;
+export type AgnosticRoute<T> = Readonly<{
+    path: string;
+    module?: T;
+    children?: ReadonlyArray<AgnosticRoute<T>>;
+}>;
+export declare function transformRoute<T, U>(route: T, getChildren: (route: T) => IterableIterator<T> | null | undefined, transformer: (route: T, children: readonly U[]) => U): U;
+export declare function extractComponentName(component?: unknown): string | undefined;
+export declare function adjustViewTitle(config?: ViewConfig, componentName?: string): ViewConfig | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/runtime/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/runtime/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,IAAI,CAAC,EAAE,QAAQ,CAAC;QACd;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;WAGG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC,CAAC;AAEH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EACjC,KAAK,EAAE,CAAC,EACR,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACjE,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,GACnD,CAAC,CAOH;AAED,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAW5E;AAKD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAanG"}

package/runtime/utils.js

@@ -0,0 +1,33 @@
+function transformRoute(route, getChildren, transformer) {
+  const children = getChildren(route);
+  return transformer(
+    route,
+    children ? Array.from(children, (child) => transformRoute(child, getChildren, transformer)) : []
+  );
+}
+function extractComponentName(component) {
+  if (component && (typeof component === "object" || typeof component === "function") && "name" in component && typeof component.name === "string") {
+    return component.name;
+  }
+  return void 0;
+}
+const viewPattern = /view/giu;
+const upperCaseSplitPattern = /(?=[A-Z])/gu;
+function adjustViewTitle(config, componentName) {
+  if (config?.title) {
+    return config;
+  }
+  if (componentName) {
+    return {
+      ...config,
+      title: componentName.replace(viewPattern, "").split(upperCaseSplitPattern).join(" ")
+    };
+  }
+  return config;
+}
+export {
+  adjustViewTitle,
+  extractComponentName,
+  transformRoute
+};
+//# sourceMappingURL=utils.js.map

package/runtime/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/runtime/utils.ts"],
+  "sourcesContent": ["export type ViewConfig = Readonly<{\n  /**\n   * View title used in the main layout header, as <title> and as the default\n   * for the menu entry. If not defined, then the view function name is converted\n   * from CamelCase after removing any \"View\" postfix.\n   */\n  title?: string;\n\n  /**\n   * Same as in the explicit React Router configuration.\n   */\n  rolesAllowed?: string[];\n\n  /**\n   * Allows overriding the route path configuration. Uses the same syntax as\n   * the path property with React Router. This can be used to define a route\n   * that conflicts with the file name conventions, e.g. /foo/index\n   */\n  route?: string;\n\n  /**\n   * Controls whether the view implementation will be lazy loaded the first time\n   * it's used or always included in the bundle. If set to undefined (which is\n   * the default), views mapped to / and /login will be eager and any other view\n   * will be lazy (this is in sync with defaults in Flow)\n   */\n  lazy?: boolean;\n\n  /**\n   * If set to false, then the route will not be registered with React Router,\n   * but it will still be included in the main menu and used to configure\n   * Spring Security\n   */\n  register?: boolean;\n\n  menu?: Readonly<{\n    /**\n     * Title to use in the menu. Falls back the title property of the view\n     * itself if not defined.\n     */\n    title?: string;\n\n    /**\n     * Used to determine the order in the menu. Ties are resolved based on the\n     * used title. Entries without explicitly defined ordering are put below\n     * entries with an order.\n     */\n    order?: number;\n    /**\n     * Set to true to explicitly exclude a view from the automatically\n     * populated menu.\n     */\n    exclude?: boolean;\n  }>;\n}>;\n\nexport type AgnosticRoute<T> = Readonly<{\n  path: string;\n  module?: T;\n  children?: ReadonlyArray<AgnosticRoute<T>>;\n}>;\n\nexport function transformRoute<T, U>(\n  route: T,\n  getChildren: (route: T) => IterableIterator<T> | null | undefined,\n  transformer: (route: T, children: readonly U[]) => U,\n): U {\n  const children = getChildren(route);\n\n  return transformer(\n    route,\n    children ? Array.from(children, (child) => transformRoute(child, getChildren, transformer)) : [],\n  );\n}\n\nexport function extractComponentName(component?: unknown): string | undefined {\n  if (\n    component &&\n    (typeof component === 'object' || typeof component === 'function') &&\n    'name' in component &&\n    typeof component.name === 'string'\n  ) {\n    return component.name;\n  }\n\n  return undefined;\n}\n\nconst viewPattern = /view/giu;\nconst upperCaseSplitPattern = /(?=[A-Z])/gu;\n\nexport function adjustViewTitle(config?: ViewConfig, componentName?: string): ViewConfig | undefined {\n  if (config?.title) {\n    return config;\n  }\n\n  if (componentName) {\n    return {\n      ...config,\n      title: componentName.replace(viewPattern, '').split(upperCaseSplitPattern).join(' '),\n    };\n  }\n\n  return config;\n}\n"],
+  "mappings": "AA8DO,SAAS,eACd,OACA,aACA,aACG;AACH,QAAM,WAAW,YAAY,KAAK;AAElC,SAAO;AAAA,IACL;AAAA,IACA,WAAW,MAAM,KAAK,UAAU,CAAC,UAAU,eAAe,OAAO,aAAa,WAAW,CAAC,IAAI,CAAC;AAAA,EACjG;AACF;AAEO,SAAS,qBAAqB,WAAyC;AAC5E,MACE,cACC,OAAO,cAAc,YAAY,OAAO,cAAc,eACvD,UAAU,aACV,OAAO,UAAU,SAAS,UAC1B;AACA,WAAO,UAAU;AAAA,EACnB;AAEA,SAAO;AACT;AAEA,MAAM,cAAc;AACpB,MAAM,wBAAwB;AAEvB,SAAS,gBAAgB,QAAqB,eAAgD;AACnG,MAAI,QAAQ,OAAO;AACjB,WAAO;AAAA,EACT;AAEA,MAAI,eAAe;AACjB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO,cAAc,QAAQ,aAAa,EAAE,EAAE,MAAM,qBAAqB,EAAE,KAAK,GAAG;AAAA,IACrF;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}

package/runtime.d.ts

@@ -0,0 +1,18 @@
+import { type ComponentType } from 'react';
+import { type RouteObject } from 'react-router';
+import { type AgnosticRoute, type ViewConfig } from './runtime/utils.js';
+export type RouteModule<P = object> = Readonly<{
+    default: ComponentType<P>;
+    config?: ViewConfig;
+}>;
+/**
+ * Transforms generated routes into a format that can be used by React Router.
+ *
+ * @param routes - Generated routes
+ */
+export declare function toReactRouter(routes: AgnosticRoute<RouteModule>): RouteObject;
+/**
+ * Hook to return the {@link ViewConfig} for the current route.
+ */
+export declare function useViewConfig<M extends ViewConfig>(): M | undefined;
+//# sourceMappingURL=runtime.d.ts.map

package/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,cAAc,CAAC;AAC5D,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,CAAC;IAC7C,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW,CAY7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,KAAK,CAAC,GAAG,SAAS,CAGnE"}

package/runtime.js

@@ -0,0 +1,28 @@
+import { createElement } from "react";
+import { useMatches } from "react-router";
+import {
+  transformRoute,
+  adjustViewTitle,
+  extractComponentName
+} from "./runtime/utils.js";
+function toReactRouter(routes) {
+  return transformRoute(
+    routes,
+    (route) => route.children?.values(),
+    ({ path, module }, children) => ({
+      path,
+      element: module?.default ? createElement(module.default) : void 0,
+      children: children.length > 0 ? children : void 0,
+      handle: adjustViewTitle(module?.config, extractComponentName(module?.default))
+    })
+  );
+}
+function useViewConfig() {
+  const matches = useMatches();
+  return matches[matches.length - 1]?.handle;
+}
+export {
+  toReactRouter,
+  useViewConfig
+};
+//# sourceMappingURL=runtime.js.map

package/runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/runtime.ts"],
+  "sourcesContent": ["import type { UIMatch } from '@remix-run/router';\nimport { type ComponentType, createElement } from 'react';\nimport { type RouteObject, useMatches } from 'react-router';\nimport {\n  type AgnosticRoute,\n  transformRoute,\n  adjustViewTitle,\n  type ViewConfig,\n  extractComponentName,\n} from './runtime/utils.js';\n\nexport type RouteModule<P = object> = Readonly<{\n  default: ComponentType<P>;\n  config?: ViewConfig;\n}>;\n\n/**\n * Transforms generated routes into a format that can be used by React Router.\n *\n * @param routes - Generated routes\n */\nexport function toReactRouter(routes: AgnosticRoute<RouteModule>): RouteObject {\n  return transformRoute(\n    routes,\n    (route) => route.children?.values(),\n    ({ path, module }, children) =>\n      ({\n        path,\n        element: module?.default ? createElement(module.default) : undefined,\n        children: children.length > 0 ? (children as RouteObject[]) : undefined,\n        handle: adjustViewTitle(module?.config, extractComponentName(module?.default)),\n      }) satisfies RouteObject,\n  );\n}\n\n/**\n * Hook to return the {@link ViewConfig} for the current route.\n */\nexport function useViewConfig<M extends ViewConfig>(): M | undefined {\n  const matches = useMatches() as ReadonlyArray<UIMatch<unknown, M>>;\n  return matches[matches.length - 1]?.handle;\n}\n"],
+  "mappings": "AACA,SAA6B,qBAAqB;AAClD,SAA2B,kBAAkB;AAC7C;AAAA,EAEE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAYA,SAAS,cAAc,QAAiD;AAC7E,SAAO;AAAA,IACL;AAAA,IACA,CAAC,UAAU,MAAM,UAAU,OAAO;AAAA,IAClC,CAAC,EAAE,MAAM,OAAO,GAAG,cAChB;AAAA,MACC;AAAA,MACA,SAAS,QAAQ,UAAU,cAAc,OAAO,OAAO,IAAI;AAAA,MAC3D,UAAU,SAAS,SAAS,IAAK,WAA6B;AAAA,MAC9D,QAAQ,gBAAgB,QAAQ,QAAQ,qBAAqB,QAAQ,OAAO,CAAC;AAAA,IAC/E;AAAA,EACJ;AACF;AAKO,SAAS,gBAAqD;AACnE,QAAM,UAAU,WAAW;AAC3B,SAAO,QAAQ,QAAQ,SAAS,CAAC,GAAG;AACtC;",
+  "names": []
+}

package/vite-plugin/collectRoutesFromFS.d.ts

@@ -0,0 +1,12 @@
+export type RouteMeta = Readonly<{
+    path: string;
+    file?: URL;
+    layout?: URL;
+    children: RouteMeta[];
+}>;
+export type CollectRoutesOptions = Readonly<{
+    extensions: readonly string[];
+    parent?: URL;
+}>;
+export default function collectRoutesFromFS(dir: URL, { extensions, parent }: CollectRoutesOptions): Promise<RouteMeta>;
+//# sourceMappingURL=collectRoutesFromFS.d.ts.map

package/vite-plugin/collectRoutesFromFS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectRoutesFromFS.d.ts","sourceRoot":"","sources":["../src/vite-plugin/collectRoutesFromFS.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,GAAG,CAAC;CACd,CAAC,CAAC;AAIH,wBAA8B,mBAAmB,CAC/C,GAAG,EAAE,GAAG,EACR,EAAE,UAAU,EAAE,MAAY,EAAE,EAAE,oBAAoB,GACjD,OAAO,CAAC,SAAS,CAAC,CAuCpB"}

package/vite-plugin/collectRoutesFromFS.js

@@ -0,0 +1,46 @@
+import { opendir } from "node:fs/promises";
+import { basename, extname, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { cleanUp } from "./utils.js";
+const collator = new Intl.Collator("en-US");
+async function collectRoutesFromFS(dir, { extensions, parent = dir }) {
+  const path = relative(fileURLToPath(parent), fileURLToPath(dir));
+  const children = [];
+  let layout;
+  for await (const d of await opendir(dir)) {
+    if (d.isDirectory()) {
+      children.push(await collectRoutesFromFS(new URL(`${d.name}/`, dir), { extensions, parent: dir }));
+    } else if (d.isFile() && extensions.includes(extname(d.name))) {
+      const file = new URL(d.name, dir);
+      const name = basename(d.name, extname(d.name));
+      if (name.startsWith("$")) {
+        if (name === "$layout") {
+          layout = file;
+        } else if (name === "$index") {
+          children.push({
+            path: "",
+            file,
+            children: []
+          });
+        } else {
+          throw new Error('Symbol "$" is reserved for special files; only "$layout" and "$index" are allowed');
+        }
+      } else if (!name.startsWith("_")) {
+        children.push({
+          path: name,
+          file,
+          children: []
+        });
+      }
+    }
+  }
+  return {
+    path,
+    layout,
+    children: children.sort(({ path: a }, { path: b }) => collator.compare(cleanUp(a), cleanUp(b)))
+  };
+}
+export {
+  collectRoutesFromFS as default
+};
+//# sourceMappingURL=collectRoutesFromFS.js.map

package/vite-plugin/collectRoutesFromFS.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/vite-plugin/collectRoutesFromFS.ts"],
+  "sourcesContent": ["import { opendir } from 'node:fs/promises';\nimport { basename, extname, relative } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { cleanUp } from './utils.js';\n\nexport type RouteMeta = Readonly<{\n  path: string;\n  file?: URL;\n  layout?: URL;\n  children: RouteMeta[];\n}>;\n\nexport type CollectRoutesOptions = Readonly<{\n  extensions: readonly string[];\n  parent?: URL;\n}>;\n\nconst collator = new Intl.Collator('en-US');\n\nexport default async function collectRoutesFromFS(\n  dir: URL,\n  { extensions, parent = dir }: CollectRoutesOptions,\n): Promise<RouteMeta> {\n  const path = relative(fileURLToPath(parent), fileURLToPath(dir));\n  const children: RouteMeta[] = [];\n  let layout: URL | undefined;\n\n  for await (const d of await opendir(dir)) {\n    if (d.isDirectory()) {\n      children.push(await collectRoutesFromFS(new URL(`${d.name}/`, dir), { extensions, parent: dir }));\n    } else if (d.isFile() && extensions.includes(extname(d.name))) {\n      const file = new URL(d.name, dir);\n      const name = basename(d.name, extname(d.name));\n\n      if (name.startsWith('$')) {\n        if (name === '$layout') {\n          layout = file;\n        } else if (name === '$index') {\n          children.push({\n            path: '',\n            file,\n            children: [],\n          });\n        } else {\n          throw new Error('Symbol \"$\" is reserved for special files; only \"$layout\" and \"$index\" are allowed');\n        }\n      } else if (!name.startsWith('_')) {\n        children.push({\n          path: name,\n          file,\n          children: [],\n        });\n      }\n    }\n  }\n\n  return {\n    path,\n    layout,\n    children: children.sort(({ path: a }, { path: b }) => collator.compare(cleanUp(a), cleanUp(b))),\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AACxB,SAAS,UAAU,SAAS,gBAAgB;AAC5C,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AAcxB,MAAM,WAAW,IAAI,KAAK,SAAS,OAAO;AAE1C,eAAO,oBACL,KACA,EAAE,YAAY,SAAS,IAAI,GACP;AACpB,QAAM,OAAO,SAAS,cAAc,MAAM,GAAG,cAAc,GAAG,CAAC;AAC/D,QAAM,WAAwB,CAAC;AAC/B,MAAI;AAEJ,mBAAiB,KAAK,MAAM,QAAQ,GAAG,GAAG;AACxC,QAAI,EAAE,YAAY,GAAG;AACnB,eAAS,KAAK,MAAM,oBAAoB,IAAI,IAAI,GAAG,EAAE,IAAI,KAAK,GAAG,GAAG,EAAE,YAAY,QAAQ,IAAI,CAAC,CAAC;AAAA,IAClG,WAAW,EAAE,OAAO,KAAK,WAAW,SAAS,QAAQ,EAAE,IAAI,CAAC,GAAG;AAC7D,YAAM,OAAO,IAAI,IAAI,EAAE,MAAM,GAAG;AAChC,YAAM,OAAO,SAAS,EAAE,MAAM,QAAQ,EAAE,IAAI,CAAC;AAE7C,UAAI,KAAK,WAAW,GAAG,GAAG;AACxB,YAAI,SAAS,WAAW;AACtB,mBAAS;AAAA,QACX,WAAW,SAAS,UAAU;AAC5B,mBAAS,KAAK;AAAA,YACZ,MAAM;AAAA,YACN;AAAA,YACA,UAAU,CAAC;AAAA,UACb,CAAC;AAAA,QACH,OAAO;AACL,gBAAM,IAAI,MAAM,mFAAmF;AAAA,QACrG;AAAA,MACF,WAAW,CAAC,KAAK,WAAW,GAAG,GAAG;AAChC,iBAAS,KAAK;AAAA,UACZ,MAAM;AAAA,UACN;AAAA,UACA,UAAU,CAAC;AAAA,QACb,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,SAAS,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAS,QAAQ,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;AAAA,EAChG;AACF;",
+  "names": []
+}

package/vite-plugin/createRoutesFromMeta.d.ts

@@ -0,0 +1,3 @@
+import type { RouteMeta } from './collectRoutesFromFS.js';
+export default function createRoutesFromMeta(views: RouteMeta, generatedDir: URL): string;
+//# sourceMappingURL=createRoutesFromMeta.d.ts.map

package/vite-plugin/createRoutesFromMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRoutesFromMeta.d.ts","sourceRoot":"","sources":["../src/vite-plugin/createRoutesFromMeta.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAyC1D,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,GAAG,MAAM,CA0CxF"}

package/vite-plugin/createRoutesFromMeta.js

@@ -0,0 +1,77 @@
+import { extname, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { template, transform as transformer } from "@vaadin/hilla-generator-utils/ast.js";
+import createSourceFile from "@vaadin/hilla-generator-utils/createSourceFile.js";
+import ts, {
+} from "typescript";
+import { transformRoute } from "../runtime/utils.js";
+import { convertFSPatternToURLPatternString } from "./utils.js";
+const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+function relativize(url, generatedDir) {
+  const result = relative(fileURLToPath(generatedDir), fileURLToPath(url));
+  if (!result.startsWith(".")) {
+    return `./${result}`;
+  }
+  return result;
+}
+function createImport(mod, file) {
+  const path = `${file.substring(0, file.lastIndexOf("."))}.js`;
+  return template(`import * as ${mod} from '${path}';
+`, ([statement]) => statement);
+}
+function createRouteData(path, mod, children) {
+  return template(
+    `const route = {
+  path: '${path}',
+  ${mod ? `module: ${mod}` : ""}
+  ${children.length > 0 ? `children: CHILDREN,` : ""}
+}`,
+    ([statement]) => statement.declarationList.declarations[0].initializer,
+    [
+      transformer(
+        (node) => ts.isIdentifier(node) && node.text === "CHILDREN" ? ts.factory.createArrayLiteralExpression(children) : node
+      )
+    ]
+  );
+}
+function createRoutesFromMeta(views, generatedDir) {
+  const imports = [];
+  let id = 0;
+  const routes = transformRoute(
+    views,
+    (view) => view.children.values(),
+    ({ file: file2, layout, path }, children) => {
+      const currentId = id;
+      id += 1;
+      let mod;
+      if (file2) {
+        mod = `Page${currentId}`;
+        imports.push(createImport(mod, relativize(file2, generatedDir)));
+      } else if (layout) {
+        mod = `Layout${currentId}`;
+        imports.push(createImport(mod, relativize(layout, generatedDir)));
+      }
+      return createRouteData(convertFSPatternToURLPatternString(path), mod, children);
+    }
+  );
+  const routeDeclaration = template(
+    `import a from 'IMPORTS';
+
+const routes = ROUTE;
+
+export default routes;
+`,
+    [
+      transformer(
+        (node) => ts.isImportDeclaration(node) && node.moduleSpecifier.text === "IMPORTS" ? imports : node
+      ),
+      transformer((node) => ts.isIdentifier(node) && node.text === "ROUTE" ? routes : node)
+    ]
+  );
+  const file = createSourceFile(routeDeclaration, "views.ts");
+  return printer.printFile(file);
+}
+export {
+  createRoutesFromMeta as default
+};
+//# sourceMappingURL=createRoutesFromMeta.js.map

package/vite-plugin/createRoutesFromMeta.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/vite-plugin/createRoutesFromMeta.ts"],
+  "sourcesContent": ["import { extname, relative } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { template, transform as transformer } from '@vaadin/hilla-generator-utils/ast.js';\nimport createSourceFile from '@vaadin/hilla-generator-utils/createSourceFile.js';\nimport ts, {\n  type ImportDeclaration,\n  type ObjectLiteralExpression,\n  type StringLiteral,\n  type VariableStatement,\n} from 'typescript';\nimport { transformRoute } from '../runtime/utils.js';\nimport type { RouteMeta } from './collectRoutesFromFS.js';\nimport { convertFSPatternToURLPatternString } from './utils.js';\n\nconst printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });\n\nfunction relativize(url: URL, generatedDir: URL): string {\n  const result = relative(fileURLToPath(generatedDir), fileURLToPath(url));\n\n  if (!result.startsWith('.')) {\n    return `./${result}`;\n  }\n\n  return result;\n}\n\nfunction createImport(mod: string, file: string): ImportDeclaration {\n  const path = `${file.substring(0, file.lastIndexOf('.'))}.js`;\n  return template(`import * as ${mod} from '${path}';\\n`, ([statement]) => statement as ts.ImportDeclaration);\n}\n\nfunction createRouteData(\n  path: string,\n  mod: string | undefined,\n  children: readonly ObjectLiteralExpression[],\n): ObjectLiteralExpression {\n  return template(\n    `const route = {\n  path: '${path}',\n  ${mod ? `module: ${mod}` : ''}\n  ${children.length > 0 ? `children: CHILDREN,` : ''}\n}`,\n    ([statement]) =>\n      (statement as VariableStatement).declarationList.declarations[0].initializer as ObjectLiteralExpression,\n    [\n      transformer((node) =>\n        ts.isIdentifier(node) && node.text === 'CHILDREN' ? ts.factory.createArrayLiteralExpression(children) : node,\n      ),\n    ],\n  );\n}\n\nexport default function createRoutesFromMeta(views: RouteMeta, generatedDir: URL): string {\n  const imports: ImportDeclaration[] = [];\n  let id = 0;\n\n  const routes = transformRoute<RouteMeta, ObjectLiteralExpression>(\n    views,\n    (view) => view.children.values(),\n    ({ file, layout, path }, children) => {\n      const currentId = id;\n      id += 1;\n\n      let mod: string | undefined;\n      if (file) {\n        mod = `Page${currentId}`;\n        imports.push(createImport(mod, relativize(file, generatedDir)));\n      } else if (layout) {\n        mod = `Layout${currentId}`;\n        imports.push(createImport(mod, relativize(layout, generatedDir)));\n      }\n\n      return createRouteData(convertFSPatternToURLPatternString(path), mod, children);\n    },\n  );\n\n  const routeDeclaration = template(\n    `import a from 'IMPORTS';\n\nconst routes = ROUTE;\n\nexport default routes;\n`,\n    [\n      transformer((node) =>\n        ts.isImportDeclaration(node) && (node.moduleSpecifier as StringLiteral).text === 'IMPORTS' ? imports : node,\n      ),\n      transformer((node) => (ts.isIdentifier(node) && node.text === 'ROUTE' ? routes : node)),\n    ],\n  );\n\n  const file = createSourceFile(routeDeclaration, 'views.ts');\n\n  return printer.printFile(file);\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS,gBAAgB;AAClC,SAAS,qBAAqB;AAC9B,SAAS,UAAU,aAAa,mBAAmB;AACnD,OAAO,sBAAsB;AAC7B,OAAO;AAAA,OAKA;AACP,SAAS,sBAAsB;AAE/B,SAAS,0CAA0C;AAEnD,MAAM,UAAU,GAAG,cAAc,EAAE,SAAS,GAAG,YAAY,SAAS,CAAC;AAErE,SAAS,WAAW,KAAU,cAA2B;AACvD,QAAM,SAAS,SAAS,cAAc,YAAY,GAAG,cAAc,GAAG,CAAC;AAEvE,MAAI,CAAC,OAAO,WAAW,GAAG,GAAG;AAC3B,WAAO,KAAK,MAAM;AAAA,EACpB;AAEA,SAAO;AACT;AAEA,SAAS,aAAa,KAAa,MAAiC;AAClE,QAAM,OAAO,GAAG,KAAK,UAAU,GAAG,KAAK,YAAY,GAAG,CAAC,CAAC;AACxD,SAAO,SAAS,eAAe,GAAG,UAAU,IAAI;AAAA,GAAQ,CAAC,CAAC,SAAS,MAAM,SAAiC;AAC5G;AAEA,SAAS,gBACP,MACA,KACA,UACyB;AACzB,SAAO;AAAA,IACL;AAAA,WACO,IAAI;AAAA,IACX,MAAM,WAAW,GAAG,KAAK,EAAE;AAAA,IAC3B,SAAS,SAAS,IAAI,wBAAwB,EAAE;AAAA;AAAA,IAEhD,CAAC,CAAC,SAAS,MACR,UAAgC,gBAAgB,aAAa,CAAC,EAAE;AAAA,IACnE;AAAA,MACE;AAAA,QAAY,CAAC,SACX,GAAG,aAAa,IAAI,KAAK,KAAK,SAAS,aAAa,GAAG,QAAQ,6BAA6B,QAAQ,IAAI;AAAA,MAC1G;AAAA,IACF;AAAA,EACF;AACF;AAEe,SAAR,qBAAsC,OAAkB,cAA2B;AACxF,QAAM,UAA+B,CAAC;AACtC,MAAI,KAAK;AAET,QAAM,SAAS;AAAA,IACb;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,OAAO;AAAA,IAC/B,CAAC,EAAE,MAAAA,OAAM,QAAQ,KAAK,GAAG,aAAa;AACpC,YAAM,YAAY;AAClB,YAAM;AAEN,UAAI;AACJ,UAAIA,OAAM;AACR,cAAM,OAAO,SAAS;AACtB,gBAAQ,KAAK,aAAa,KAAK,WAAWA,OAAM,YAAY,CAAC,CAAC;AAAA,MAChE,WAAW,QAAQ;AACjB,cAAM,SAAS,SAAS;AACxB,gBAAQ,KAAK,aAAa,KAAK,WAAW,QAAQ,YAAY,CAAC,CAAC;AAAA,MAClE;AAEA,aAAO,gBAAgB,mCAAmC,IAAI,GAAG,KAAK,QAAQ;AAAA,IAChF;AAAA,EACF;AAEA,QAAM,mBAAmB;AAAA,IACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA;AAAA,MACE;AAAA,QAAY,CAAC,SACX,GAAG,oBAAoB,IAAI,KAAM,KAAK,gBAAkC,SAAS,YAAY,UAAU;AAAA,MACzG;AAAA,MACA,YAAY,CAAC,SAAU,GAAG,aAAa,IAAI,KAAK,KAAK,SAAS,UAAU,SAAS,IAAK;AAAA,IACxF;AAAA,EACF;AAEA,QAAM,OAAO,iBAAiB,kBAAkB,UAAU;AAE1D,SAAO,QAAQ,UAAU,IAAI;AAC/B;",
+  "names": ["file"]
+}

package/vite-plugin/createViewConfigJson.d.ts

@@ -0,0 +1,3 @@
+import type { RouteMeta } from './collectRoutesFromFS.js';
+export default function createViewConfigJson(views: RouteMeta, configExportName: string): Promise<string>;
+//# sourceMappingURL=createViewConfigJson.d.ts.map

package/vite-plugin/createViewConfigJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createViewConfigJson.d.ts","sourceRoot":"","sources":["../src/vite-plugin/createViewConfigJson.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AA0B1D,wBAA8B,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC9G"}

package/vite-plugin/createViewConfigJson.js

@@ -0,0 +1,56 @@
+import { readFile } from "node:fs/promises";
+import { Script } from "node:vm";
+import ts, {} from "typescript";
+import { adjustViewTitle } from "../runtime/utils.js";
+import { convertFSPatternToURLPatternString } from "./utils.js";
+function* traverse(views, parents = []) {
+  const chain = [...parents, views];
+  if (views.children.length === 0) {
+    yield chain;
+  }
+  for (const child of views.children) {
+    yield* traverse(child, chain);
+  }
+}
+function* walkAST(node) {
+  yield node;
+  for (const child of node.getChildren()) {
+    yield* walkAST(child);
+  }
+}
+async function createViewConfigJson(views, configExportName) {
+  const res = await Promise.all(
+    Array.from(traverse(views), async (branch) => {
+      const configs = await Promise.all(
+        branch.filter(({ file, layout }) => !!file || !!layout).map(({ file, layout }) => file ?? layout).map(async (path) => {
+          const file = ts.createSourceFile("f.ts", await readFile(path, "utf8"), ts.ScriptTarget.ESNext, true);
+          let config;
+          let waitingForIdentifier = false;
+          let componentName;
+          for (const node of walkAST(file)) {
+            if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.name.text === configExportName) {
+              if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {
+                const code = node.initializer.getText(file);
+                const script = new Script(`(${code})`);
+                config = script.runInThisContext();
+              }
+            } else if (node.getText(file).includes("export default")) {
+              waitingForIdentifier = true;
+            } else if (waitingForIdentifier && ts.isIdentifier(node)) {
+              componentName = node.text;
+            }
+          }
+          return adjustViewTitle(config, componentName);
+        })
+      );
+      const key = branch.map(({ path }) => convertFSPatternToURLPatternString(path)).join("/");
+      const value = configs[configs.length - 1];
+      return [key, value];
+    })
+  );
+  return JSON.stringify(Object.fromEntries(res));
+}
+export {
+  createViewConfigJson as default
+};
+//# sourceMappingURL=createViewConfigJson.js.map

package/vite-plugin/createViewConfigJson.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/vite-plugin/createViewConfigJson.ts"],
+  "sourcesContent": ["import { readFile } from 'node:fs/promises';\nimport { Script } from 'node:vm';\nimport ts, { type Node } from 'typescript';\nimport { adjustViewTitle, type ViewConfig } from '../runtime/utils.js';\nimport type { RouteMeta } from './collectRoutesFromFS.js';\nimport { convertFSPatternToURLPatternString } from './utils.js';\n\nfunction* traverse(\n  views: RouteMeta,\n  parents: readonly RouteMeta[] = [],\n): Generator<readonly RouteMeta[], undefined, undefined> {\n  const chain = [...parents, views];\n\n  if (views.children.length === 0) {\n    yield chain;\n  }\n\n  for (const child of views.children) {\n    yield* traverse(child, chain);\n  }\n}\n\nfunction* walkAST(node: Node): Generator<Node> {\n  yield node;\n\n  for (const child of node.getChildren()) {\n    yield* walkAST(child);\n  }\n}\n\nexport default async function createViewConfigJson(views: RouteMeta, configExportName: string): Promise<string> {\n  const res = await Promise.all(\n    Array.from(traverse(views), async (branch) => {\n      const configs = await Promise.all(\n        branch\n          .filter(({ file, layout }) => !!file || !!layout)\n          .map(({ file, layout }) => file ?? layout!)\n          .map(async (path) => {\n            const file = ts.createSourceFile('f.ts', await readFile(path, 'utf8'), ts.ScriptTarget.ESNext, true);\n            let config: ViewConfig | undefined;\n            let waitingForIdentifier = false;\n            let componentName: string | undefined;\n\n            for (const node of walkAST(file)) {\n              if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.name.text === configExportName) {\n                if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\n                  const code = node.initializer.getText(file);\n                  const script = new Script(`(${code})`);\n                  config = script.runInThisContext() as ViewConfig;\n                }\n              } else if (node.getText(file).includes('export default')) {\n                waitingForIdentifier = true;\n              } else if (waitingForIdentifier && ts.isIdentifier(node)) {\n                componentName = node.text;\n              }\n            }\n\n            return adjustViewTitle(config, componentName);\n          }),\n      );\n\n      const key = branch.map(({ path }) => convertFSPatternToURLPatternString(path)).join('/');\n      const value = configs[configs.length - 1];\n\n      return [key, value] satisfies readonly [string, ViewConfig | undefined];\n    }),\n  );\n\n  return JSON.stringify(Object.fromEntries(res));\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,OAAO,YAAuB;AAC9B,SAAS,uBAAwC;AAEjD,SAAS,0CAA0C;AAEnD,UAAU,SACR,OACA,UAAgC,CAAC,GACsB;AACvD,QAAM,QAAQ,CAAC,GAAG,SAAS,KAAK;AAEhC,MAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,UAAM;AAAA,EACR;AAEA,aAAW,SAAS,MAAM,UAAU;AAClC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AACF;AAEA,UAAU,QAAQ,MAA6B;AAC7C,QAAM;AAEN,aAAW,SAAS,KAAK,YAAY,GAAG;AACtC,WAAO,QAAQ,KAAK;AAAA,EACtB;AACF;AAEA,eAAO,qBAA4C,OAAkB,kBAA2C;AAC9G,QAAM,MAAM,MAAM,QAAQ;AAAA,IACxB,MAAM,KAAK,SAAS,KAAK,GAAG,OAAO,WAAW;AAC5C,YAAM,UAAU,MAAM,QAAQ;AAAA,QAC5B,OACG,OAAO,CAAC,EAAE,MAAM,OAAO,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,EAC/C,IAAI,CAAC,EAAE,MAAM,OAAO,MAAM,QAAQ,MAAO,EACzC,IAAI,OAAO,SAAS;AACnB,gBAAM,OAAO,GAAG,iBAAiB,QAAQ,MAAM,SAAS,MAAM,MAAM,GAAG,GAAG,aAAa,QAAQ,IAAI;AACnG,cAAI;AACJ,cAAI,uBAAuB;AAC3B,cAAI;AAEJ,qBAAW,QAAQ,QAAQ,IAAI,GAAG;AAChC,gBAAI,GAAG,sBAAsB,IAAI,KAAK,GAAG,aAAa,KAAK,IAAI,KAAK,KAAK,KAAK,SAAS,kBAAkB;AACvG,kBAAI,KAAK,eAAe,GAAG,0BAA0B,KAAK,WAAW,GAAG;AACtE,sBAAM,OAAO,KAAK,YAAY,QAAQ,IAAI;AAC1C,sBAAM,SAAS,IAAI,OAAO,IAAI,IAAI,GAAG;AACrC,yBAAS,OAAO,iBAAiB;AAAA,cACnC;AAAA,YACF,WAAW,KAAK,QAAQ,IAAI,EAAE,SAAS,gBAAgB,GAAG;AACxD,qCAAuB;AAAA,YACzB,WAAW,wBAAwB,GAAG,aAAa,IAAI,GAAG;AACxD,8BAAgB,KAAK;AAAA,YACvB;AAAA,UACF;AAEA,iBAAO,gBAAgB,QAAQ,aAAa;AAAA,QAC9C,CAAC;AAAA,MACL;AAEA,YAAM,MAAM,OAAO,IAAI,CAAC,EAAE,KAAK,MAAM,mCAAmC,IAAI,CAAC,EAAE,KAAK,GAAG;AACvF,YAAM,QAAQ,QAAQ,QAAQ,SAAS,CAAC;AAExC,aAAO,CAAC,KAAK,KAAK;AAAA,IACpB,CAAC;AAAA,EACH;AAEA,SAAO,KAAK,UAAU,OAAO,YAAY,GAAG,CAAC;AAC/C;",
+  "names": []
+}

package/vite-plugin/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Converts a file system pattern to a URL pattern string.
+ *
+ * @param fsPattern - a string representing a file system pattern:
+ * - `{param}` - for a required single parameter;
+ * - `{{param}}` - for an optional single parameter;
+ * - `{...rest}` - for multiple parameters, including none.
+ *
+ * @returns a string representing a URL pattern, respectively:
+ * - `:param`;
+ * - `:param?`;
+ * - `*`.
+ */
+export declare function convertFSPatternToURLPatternString(fsPattern: string): string;
+/**
+ * A small helper function that clears route path of the control characters in
+ * order to sort the routes alphabetically.
+ */
+export declare function cleanUp(path: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/vite-plugin/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/vite-plugin/utils.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAU5E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/vite-plugin/utils.js

@@ -0,0 +1,14 @@
+const restParamPattern = /\{\.{3}(.+)\}/gu;
+const optionalParamPattern = /\{{2}(.+)\}{2}/gu;
+const paramPattern = /\{(.+)\}/gu;
+function convertFSPatternToURLPatternString(fsPattern) {
+  return fsPattern.replaceAll(restParamPattern, "*").replaceAll(optionalParamPattern, ":$1?").replaceAll(paramPattern, ":$1");
+}
+function cleanUp(path) {
+  return path.replaceAll(restParamPattern, "$1").replaceAll(optionalParamPattern, "$1").replaceAll(paramPattern, "$1");
+}
+export {
+  cleanUp,
+  convertFSPatternToURLPatternString
+};
+//# sourceMappingURL=utils.js.map

package/vite-plugin/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/vite-plugin/utils.ts"],
+  "sourcesContent": ["const restParamPattern = /\\{\\.{3}(.+)\\}/gu;\nconst optionalParamPattern = /\\{{2}(.+)\\}{2}/gu;\nconst paramPattern = /\\{(.+)\\}/gu;\n\n/**\n * Converts a file system pattern to a URL pattern string.\n *\n * @param fsPattern - a string representing a file system pattern:\n * - `{param}` - for a required single parameter;\n * - `{{param}}` - for an optional single parameter;\n * - `{...rest}` - for multiple parameters, including none.\n *\n * @returns a string representing a URL pattern, respectively:\n * - `:param`;\n * - `:param?`;\n * - `*`.\n */\nexport function convertFSPatternToURLPatternString(fsPattern: string): string {\n  return (\n    fsPattern\n      // /url/{...rest}/page -> /url/*/page\n      .replaceAll(restParamPattern, '*')\n      // /url/{{param}}/page -> /url/:param?/page\n      .replaceAll(optionalParamPattern, ':$1?')\n      // /url/{param}/page -> /url/:param/page\n      .replaceAll(paramPattern, ':$1')\n  );\n}\n\n/**\n * A small helper function that clears route path of the control characters in\n * order to sort the routes alphabetically.\n */\nexport function cleanUp(path: string): string {\n  return path.replaceAll(restParamPattern, '$1').replaceAll(optionalParamPattern, '$1').replaceAll(paramPattern, '$1');\n}\n"],
+  "mappings": "AAAA,MAAM,mBAAmB;AACzB,MAAM,uBAAuB;AAC7B,MAAM,eAAe;AAed,SAAS,mCAAmC,WAA2B;AAC5E,SACE,UAEG,WAAW,kBAAkB,GAAG,EAEhC,WAAW,sBAAsB,MAAM,EAEvC,WAAW,cAAc,KAAK;AAErC;AAMO,SAAS,QAAQ,MAAsB;AAC5C,SAAO,KAAK,WAAW,kBAAkB,IAAI,EAAE,WAAW,sBAAsB,IAAI,EAAE,WAAW,cAAc,IAAI;AACrH;",
+  "names": []
+}

package/vite-plugin-file-router.d.ts

@@ -0,0 +1,38 @@
+import type { Plugin } from 'vite';
+export type PluginOptions = Readonly<{
+    /**
+     * The base directory for the router. The folders and files in this directory
+     * will be used as route paths.
+     *
+     * @defaultValue `frontend/views`
+     */
+    viewsDir?: URL | string;
+    /**
+     * The directory where the generated view file will be stored.
+     *
+     * @defaultValue `frontend/generated`
+     */
+    generatedDir?: URL | string;
+    /**
+     * The list of extensions that will be collected as routes of the file-based
+     * router.
+     *
+     * @defaultValue `['.tsx', '.jsx', '.ts', '.js']`
+     */
+    extensions?: readonly string[];
+    /**
+     * The name of the export that will be used for the {@link ViewConfig} in the
+     * route file.
+     *
+     * @defaultValue `config`
+     */
+    configExportName?: string;
+}>;
+/**
+ * A Vite plugin that generates a router from the files in the specific directory.
+ *
+ * @param options - The plugin options.
+ * @returns A Vite plugin.
+ */
+export default function vitePluginFileSystemRouter({ viewsDir, generatedDir, extensions, configExportName, }?: PluginOptions): Plugin;
+//# sourceMappingURL=vite-plugin-file-router.d.ts.map

package/vite-plugin-file-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-file-router.d.ts","sourceRoot":"","sources":["src/vite-plugin-file-router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAKnC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAyBH;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,EACjD,QAA4B,EAC5B,YAAoC,EACpC,UAA2C,EAC3C,gBAA2B,GAC5B,GAAE,aAAkB,GAAG,MAAM,CAqC7B"}

package/vite-plugin-file-router.js

@@ -0,0 +1,57 @@
+import { writeFile } from "node:fs/promises";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import collectRoutesFromFS from "./vite-plugin/collectRoutesFromFS.js";
+import createRoutesFromMeta from "./vite-plugin/createRoutesFromMeta.js";
+import createViewConfigJson from "./vite-plugin/createViewConfigJson.js";
+async function generateRuntimeFiles(code, json, urls) {
+  await Promise.all([writeFile(urls.json, json, "utf-8"), writeFile(urls.code, code, "utf-8")]);
+}
+async function build(viewsDir, outDir, generatedUrls, extensions, configExportName) {
+  const routeMeta = await collectRoutesFromFS(viewsDir, { extensions });
+  const runtimeRoutesCode = createRoutesFromMeta(routeMeta, outDir);
+  const viewConfigJson = await createViewConfigJson(routeMeta, configExportName);
+  await generateRuntimeFiles(runtimeRoutesCode, viewConfigJson, generatedUrls);
+}
+function vitePluginFileSystemRouter({
+  viewsDir = "frontend/views/",
+  generatedDir = "frontend/generated/",
+  extensions = [".tsx", ".jsx", ".ts", ".js"],
+  configExportName = "config"
+} = {}) {
+  let _viewsDir;
+  let _generatedDir;
+  let _outDir;
+  let generatedUrls;
+  return {
+    name: "vite-plugin-file-router",
+    configResolved({ root, build: { outDir } }) {
+      const _root = pathToFileURL(root);
+      _viewsDir = new URL(viewsDir, _root);
+      _generatedDir = new URL(generatedDir, _root);
+      _outDir = pathToFileURL(outDir);
+      generatedUrls = {
+        json: new URL("views.json", _outDir),
+        code: new URL("views.ts", _generatedDir)
+      };
+    },
+    async buildStart() {
+      await build(_viewsDir, _generatedDir, generatedUrls, extensions, configExportName);
+    },
+    configureServer(server) {
+      const dir = fileURLToPath(_viewsDir);
+      const changeListener = (file) => {
+        if (!file.startsWith(dir)) {
+          return;
+        }
+        build(_viewsDir, _outDir, generatedUrls, extensions, configExportName).catch((error) => console.error(error));
+      };
+      server.watcher.on("add", changeListener);
+      server.watcher.on("change", changeListener);
+      server.watcher.on("unlink", changeListener);
+    }
+  };
+}
+export {
+  vitePluginFileSystemRouter as default
+};
+//# sourceMappingURL=vite-plugin-file-router.js.map

package/vite-plugin-file-router.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/vite-plugin-file-router.ts"],
+  "sourcesContent": ["import { writeFile } from 'node:fs/promises';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport type { Plugin } from 'vite';\nimport collectRoutesFromFS from './vite-plugin/collectRoutesFromFS.js';\nimport createRoutesFromMeta from './vite-plugin/createRoutesFromMeta.js';\nimport createViewConfigJson from './vite-plugin/createViewConfigJson.js';\n\nexport type PluginOptions = Readonly<{\n  /**\n   * The base directory for the router. The folders and files in this directory\n   * will be used as route paths.\n   *\n   * @defaultValue `frontend/views`\n   */\n  viewsDir?: URL | string;\n  /**\n   * The directory where the generated view file will be stored.\n   *\n   * @defaultValue `frontend/generated`\n   */\n  generatedDir?: URL | string;\n  /**\n   * The list of extensions that will be collected as routes of the file-based\n   * router.\n   *\n   * @defaultValue `['.tsx', '.jsx', '.ts', '.js']`\n   */\n  extensions?: readonly string[];\n  /**\n   * The name of the export that will be used for the {@link ViewConfig} in the\n   * route file.\n   *\n   * @defaultValue `config`\n   */\n  configExportName?: string;\n}>;\n\ntype RuntimeFileUrls = Readonly<{\n  json: URL;\n  code: URL;\n}>;\n\nasync function generateRuntimeFiles(code: string, json: string, urls: RuntimeFileUrls) {\n  await Promise.all([writeFile(urls.json, json, 'utf-8'), writeFile(urls.code, code, 'utf-8')]);\n}\n\nasync function build(\n  viewsDir: URL,\n  outDir: URL,\n  generatedUrls: RuntimeFileUrls,\n  extensions: readonly string[],\n  configExportName: string,\n): Promise<void> {\n  const routeMeta = await collectRoutesFromFS(viewsDir, { extensions });\n  const runtimeRoutesCode = createRoutesFromMeta(routeMeta, outDir);\n  const viewConfigJson = await createViewConfigJson(routeMeta, configExportName);\n\n  await generateRuntimeFiles(runtimeRoutesCode, viewConfigJson, generatedUrls);\n}\n\n/**\n * A Vite plugin that generates a router from the files in the specific directory.\n *\n * @param options - The plugin options.\n * @returns A Vite plugin.\n */\nexport default function vitePluginFileSystemRouter({\n  viewsDir = 'frontend/views/',\n  generatedDir = 'frontend/generated/',\n  extensions = ['.tsx', '.jsx', '.ts', '.js'],\n  configExportName = 'config',\n}: PluginOptions = {}): Plugin {\n  let _viewsDir: URL;\n  let _generatedDir: URL;\n  let _outDir: URL;\n  let generatedUrls: RuntimeFileUrls;\n\n  return {\n    name: 'vite-plugin-file-router',\n    configResolved({ root, build: { outDir } }) {\n      const _root = pathToFileURL(root);\n      _viewsDir = new URL(viewsDir, _root);\n      _generatedDir = new URL(generatedDir, _root);\n      _outDir = pathToFileURL(outDir);\n      generatedUrls = {\n        json: new URL('views.json', _outDir),\n        code: new URL('views.ts', _generatedDir),\n      };\n    },\n    async buildStart() {\n      await build(_viewsDir, _generatedDir, generatedUrls, extensions, configExportName);\n    },\n    configureServer(server) {\n      const dir = fileURLToPath(_viewsDir);\n\n      const changeListener = (file: string): void => {\n        if (!file.startsWith(dir)) {\n          return;\n        }\n\n        build(_viewsDir, _outDir, generatedUrls, extensions, configExportName).catch((error) => console.error(error));\n      };\n\n      server.watcher.on('add', changeListener);\n      server.watcher.on('change', changeListener);\n      server.watcher.on('unlink', changeListener);\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAC1B,SAAS,eAAe,qBAAqB;AAE7C,OAAO,yBAAyB;AAChC,OAAO,0BAA0B;AACjC,OAAO,0BAA0B;AAqCjC,eAAe,qBAAqB,MAAc,MAAc,MAAuB;AACrF,QAAM,QAAQ,IAAI,CAAC,UAAU,KAAK,MAAM,MAAM,OAAO,GAAG,UAAU,KAAK,MAAM,MAAM,OAAO,CAAC,CAAC;AAC9F;AAEA,eAAe,MACb,UACA,QACA,eACA,YACA,kBACe;AACf,QAAM,YAAY,MAAM,oBAAoB,UAAU,EAAE,WAAW,CAAC;AACpE,QAAM,oBAAoB,qBAAqB,WAAW,MAAM;AAChE,QAAM,iBAAiB,MAAM,qBAAqB,WAAW,gBAAgB;AAE7E,QAAM,qBAAqB,mBAAmB,gBAAgB,aAAa;AAC7E;AAQe,SAAR,2BAA4C;AAAA,EACjD,WAAW;AAAA,EACX,eAAe;AAAA,EACf,aAAa,CAAC,QAAQ,QAAQ,OAAO,KAAK;AAAA,EAC1C,mBAAmB;AACrB,IAAmB,CAAC,GAAW;AAC7B,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,SAAO;AAAA,IACL,MAAM;AAAA,IACN,eAAe,EAAE,MAAM,OAAO,EAAE,OAAO,EAAE,GAAG;AAC1C,YAAM,QAAQ,cAAc,IAAI;AAChC,kBAAY,IAAI,IAAI,UAAU,KAAK;AACnC,sBAAgB,IAAI,IAAI,cAAc,KAAK;AAC3C,gBAAU,cAAc,MAAM;AAC9B,sBAAgB;AAAA,QACd,MAAM,IAAI,IAAI,cAAc,OAAO;AAAA,QACnC,MAAM,IAAI,IAAI,YAAY,aAAa;AAAA,MACzC;AAAA,IACF;AAAA,IACA,MAAM,aAAa;AACjB,YAAM,MAAM,WAAW,eAAe,eAAe,YAAY,gBAAgB;AAAA,IACnF;AAAA,IACA,gBAAgB,QAAQ;AACtB,YAAM,MAAM,cAAc,SAAS;AAEnC,YAAM,iBAAiB,CAAC,SAAuB;AAC7C,YAAI,CAAC,KAAK,WAAW,GAAG,GAAG;AACzB;AAAA,QACF;AAEA,cAAM,WAAW,SAAS,eAAe,YAAY,gBAAgB,EAAE,MAAM,CAAC,UAAU,QAAQ,MAAM,KAAK,CAAC;AAAA,MAC9G;AAEA,aAAO,QAAQ,GAAG,OAAO,cAAc;AACvC,aAAO,QAAQ,GAAG,UAAU,cAAc;AAC1C,aAAO,QAAQ,GAAG,UAAU,cAAc;AAAA,IAC5C;AAAA,EACF;AACF;",
+  "names": []
+}