@nifrajs/web 3.3.0 → 4.0.0

package/dist/llms-txt.js

@@ -1,4 +1,5 @@
-import { reflectRoutes } from "@nifrajs/core/reflection";
+import { reflectedRoutesFromEvidence, snapshotProjectEvidence, } from "@nifrajs/core/evidence";
+import { compileRoutePattern } from "@nifrajs/core/pattern";
 const IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
 function tsTypeOf(schema, depth = 0) {
     if (typeof schema !== "object" || schema === null || depth > 6)
@@ -40,6 +41,35 @@ function tsTypeOf(schema, depth = 0) {
             return JSON.stringify(schema);
     }
 }
+/**
+ * The call a non-static segment adds to the typed-client chain, or `undefined` for a static one. Read
+ * by the router's own grammar: a whole param or a wildcard is called by its name (`:id` and
+ * `:id{[0-9]+}` are `({ id })`), and a segment that is part literal, part parameter is called with
+ * the segment text (`:name.json` is ``(`${name}.json`)``).
+ */
+function paramCall(seg) {
+    let segment;
+    try {
+        segment = compileRoutePattern(`/${seg}`).segments[0];
+    }
+    catch {
+        return undefined;
+    }
+    if (segment === undefined || segment.kind === "static")
+        return undefined;
+    if (segment.kind === "param")
+        return `({ ${segment.name} })`;
+    if (segment.kind === "wildcard") {
+        return segment.name === "*" ? '({ "*": rest })' : `({ ${segment.name} })`;
+    }
+    const [only] = segment.parts;
+    if (segment.parts.length === 1 && only?.t === "param")
+        return `({ ${only.name} })`;
+    const text = segment.parts
+        .map((part) => (part.t === "lit" ? part.v.replace(/[`\\]|\$\{/g, "\\$&") : `\${${part.name}}`))
+        .join("");
+    return `(\`${text}\`)`;
+}
 function clientCall(method, path, schema) {
     const s = schema;
     const verb = method.toLowerCase();
@@ -49,12 +79,7 @@ function clientCall(method, path, schema) {
         chain += ".index";
     else
         for (const seg of segs) {
-            if (seg.startsWith(":") || seg.startsWith("*")) {
-                const name = seg.replace(/^[:*]/, "") || "value";
-                chain += `({ ${name} })`;
-            }
-            else
-                chain += IDENT.test(seg) ? `.${seg}` : `[${JSON.stringify(seg)}]`;
+            chain += paramCall(seg) ?? (IDENT.test(seg) ? `.${seg}` : `[${JSON.stringify(seg)}]`);
         }
     const isBodyVerb = verb === "post" || verb === "put" || verb === "patch";
     let call;
@@ -107,7 +132,7 @@ export async function generateLlmsTxt(full, pageRoutes, backend, options = {}) {
     output += `\n`;
     // 3. API Routes
     output += `## API Routes\n\n`;
-    const apiRoutes = reflectRoutes(backend);
+    const apiRoutes = reflectedRoutesFromEvidence(options.evidence ?? snapshotProjectEvidence(backend));
     if (apiRoutes.length === 0) {
         output += `No API routes registered.\n`;
     }
@@ -130,7 +155,10 @@ export async function generateLlmsTxt(full, pageRoutes, backend, options = {}) {
                     output += `  - Response Schema: \`${tsTypeOf(responseSchema)}\`\n`;
                 }
                 if (s?.errors) {
-                    for (const [status, errorSchema] of Object.entries(s.errors)) {
+                    for (const status of Object.keys(s.errors)) {
+                        const errorSchema = s.errors[status];
+                        if (errorSchema === undefined)
+                            continue;
                         const errJson = errorSchema.jsonSchema;
                         if (errJson !== undefined) {
                             output += `  - Error ${status} Schema: \`${tsTypeOf(errJson)}\`\n`;

package/dist/llms-txt.js.map

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

package/dist/manifest.d.ts

@@ -1,11 +1,30 @@
+import type { CookieOptions, ResponseResult, StandardSchemaV1 } from "@nifrajs/core/server";
+import type { BoundaryDescriptor, BoundaryRegistration } from "./boundary.js";
+import type { RevalidateTags } from "./isr.js";
 /**
- * Route manifest - the fs-free heart of file-based routing. Maps route file paths to nifra
- * router patterns + their nested layout chain. `discoverRoutes` (in `@nifrajs/web/fs`) scans
- * the filesystem and feeds `buildManifest`; everything here is pure logic, so it stays
- * portable (no fs, no DOM) and fully unit-testable. Edge deploys pre-build the manifest.
+ * Response controls a loader or action reaches as `ctx.set` - the page counterpart of a route
+ * handler's `c.set`. Write before the loader or action returns; a write from a deferred promise that
+ * settles later throws.
  */
-import type { StandardSchemaV1 } from "@nifrajs/core/server";
-import type { BoundaryDescriptor, BoundaryRegistration } from "./boundary.js";
+export interface LoaderResponseControls {
+    /**
+     * Headers for the rendered document (`cache-control`, `x-robots-tag`, `link`, ...). A layout's
+     * headers are applied first, then the page's, then the action's, so the most specific writer wins a
+     * name. They are not applied to a redirect, a status page, an error page, or a navigation data
+     * response. `content-type`, `set-cookie`, `location`, transport headers, and the `x-nifra-` prefix
+     * are refused.
+     */
+    readonly headers: Record<string, string>;
+    /**
+     * Queue a `Set-Cookie`, with the same secure defaults as `c.set.cookie`
+     * (`HttpOnly; Secure; SameSite=Lax; Path=/`). The cookie rides every outcome - the document, a
+     * navigation data response, a redirect, a status or error page - and makes the response
+     * `cache-control: private, no-store`.
+     */
+    cookie(name: string, value: string, options?: CookieOptions): void;
+    /** Queue a cookie deletion. Match the `path`/`domain` the cookie was set with. */
+    deleteCookie(name: string, options?: Pick<CookieOptions, "path" | "domain">): void;
+}
 /** Context passed to a route `loader`. The `api` + `env` are injected by `createWebApp` and typed
  * per-route via `@nifrajs/client`'s `LoaderArgs<Api, Env>` (here they are opaque to the agnostic core). */
 export interface LoaderContext {
@@ -23,9 +42,58 @@ export interface LoaderContext {
      * declares one - failing closed to the schema's defaults - else the raw parsed query. Typed per-route
      * via `@nifrajs/client`'s `LoaderArgs<Api, Env, Search>`. */
     readonly search: Record<string, unknown>;
+    /** Response headers and cookies for this page request. */
+    readonly set: LoaderResponseControls;
 }
 /** A route's optional data loader: params/request in, data out. */
 export type Loader = (ctx: LoaderContext) => unknown | Promise<unknown>;
+/**
+ * The `middleware` export of a `_layout.backend.ts` file. It runs on the server before the layouts, loaders and
+ * action of every route in its directory and below - on a document request, a client navigation and a
+ * form post alike - and before a nested `_404` there. Middleware higher in the tree runs first.
+ *
+ * - Return nothing to let the request through.
+ * - Return or throw a `redirect()`, a status such as `notFound()`, or a `Response` to answer with it:
+ *   nothing below the middleware runs.
+ * - `ctx.set` adds headers and cookies as a loader's does. A layout's or the page's header of the same
+ *   name wins.
+ * - `ctx.params` holds the params of the directory's own URL prefix, as a layout's loader sees them.
+ *
+ * It does not run for a prerendered page, an ISR cache hit, a mounted API or a static file. For
+ * middleware on every request, export `use` from `backend/framework.ts`. Pass a typed context to type
+ * `ctx.api` and `ctx.env`: `RouteMiddleware<LoaderArgs<typeof app, Env>>`.
+ */
+export type RouteMiddleware<Ctx = LoaderContext> = (ctx: Ctx) => MiddlewareOutcome | Promise<MiddlewareOutcome>;
+/** What a {@link RouteMiddleware} answers with: nothing, to let the request through, or a response. */
+export type MiddlewareOutcome = undefined | Response | ResponseResult;
+/** One client navigation, as a layout's {@link ShouldRevalidate} sees it. */
+export interface ShouldRevalidateArgs {
+    /** The URL the client is leaving. */
+    readonly currentUrl: URL;
+    /** The URL being loaded. */
+    readonly nextUrl: URL;
+    /** Every route param of the page being left - not only the ones the layout owns. */
+    readonly currentParams: Readonly<Record<string, string>>;
+    /** Every route param of the page being loaded. */
+    readonly nextParams: Readonly<Record<string, string>>;
+    /** The answer without the hook: `true` when a param the layout owns or the query changed. */
+    readonly defaultShouldRevalidate: boolean;
+}
+/**
+ * A layout's say over whether its loader runs again on a client navigation. Export it from a
+ * `_layout.backend.ts` next to the loader: `export const shouldRevalidate: ShouldRevalidate = (args) => ...`.
+ *
+ * - Asked on the server, on a client navigation that keeps this layout on screen, when the browser
+ *   already holds its data. A document request, the revalidation after an action, and
+ *   `router.invalidate()` always run the loader.
+ * - Return `false` to keep the data the browser has; any other value runs the loader. Return
+ *   `args.defaultShouldRevalidate` to keep the default for the cases you do not handle.
+ * - Must be synchronous: a returned promise is not `false`, so the loader runs.
+ * - Never asked for a `gate` layout, which runs on every request.
+ * - A page's loader runs on every navigation and a page's `shouldRevalidate` is not read. Query keys
+ *   a page's loader never uses belong in its `searchClientKeys`.
+ */
+export type ShouldRevalidate = (args: ShouldRevalidateArgs) => boolean;
 /**
  * A route's optional mutation, run on POST. Shares the loader context (params/request/api);
  * read the form/JSON body off `request`. Returns either a control-flow value (a `redirect()`, a
@@ -55,13 +123,14 @@ export interface ClientActionResult {
     readonly optimisticData?: unknown;
 }
 /** A client-only action wrapper; it never replaces the server action. */
-export type ClientAction = (args: ClientActionArgs) => ClientActionResult | void | Promise<ClientActionResult | void>;
+export type ClientAction = (args: ClientActionArgs) => ClientActionResult | undefined | Promise<ClientActionResult | undefined>;
 /** Client hooks populated by the generated route entry after a route chunk loads. */
 export interface ClientRouteHooks {
     readonly clientLoader?: ClientLoader;
     readonly clientAction?: ClientAction;
-    /** Neutral boundary descriptors needed for soft-navigation interception; no server loader crosses. */
-    readonly boundaries?: readonly BoundaryDescriptor[];
+    /** Neutral boundary descriptors needed for soft-navigation interception. A boundary's loader lives in
+     * the route's backend half, so the browser never learns whether one exists. */
+    readonly boundaries?: ReadonlyArray<Omit<BoundaryDescriptor, "hasLoad">>;
 }
 /**
  * One `<link>` tag's attributes for a route/layout's `meta.link`. The common HTML `<link>` attributes
@@ -170,6 +239,8 @@ export interface Meta {
 export interface MetaArgs<Data = unknown> {
     readonly data: Data;
     readonly params: Record<string, string>;
+    /** The resolved document CSP nonce, when this render uses per-request nonce protection. */
+    readonly nonce?: string;
     /**
      * The site origin - scheme + host (+ port), e.g. `"https://news.example.com"`, **with no trailing
      * slash**. The single piece of server/env knowledge `meta()` otherwise can't see: it runs in BOTH
@@ -208,12 +279,24 @@ export interface RouteModule {
     readonly default: unknown;
     readonly loader?: Loader;
     readonly action?: Action;
+    /**
+     * Backend half only: the schema of what {@link loader} sends to the browser. Required whenever the
+     * loader returns data. Keys it does not declare are dropped before the page renders; a declared
+     * field of the wrong shape fails the request with a 500 naming the field's path.
+     */
+    readonly loaderOutput?: StandardSchemaV1;
+    /** Backend half only: the schema of what {@link action} sends back, held to the same rule. */
+    readonly actionOutput?: StandardSchemaV1;
     /** Optional client-only loader. It runs after hydration and on client navigations. */
     readonly clientLoader?: ClientLoader;
     /** Optional client-only submit wrapper. The server action remains mandatory for mutations. */
     readonly clientAction?: ClientAction;
-    /** Named async boundaries owned by this route. The adapter renders their neutral state seam. */
+    /** Named async boundaries owned by this route. The adapter renders their neutral state seam. A
+     * boundary's `load` comes from {@link boundaryLoaders} in the route's backend half; the frontend
+     * file declares only how it renders. */
     readonly boundaries?: readonly BoundaryRegistration[];
+    /** Backend half only: each boundary's server loader, keyed by boundary name. */
+    readonly boundaryLoaders?: Readonly<Record<string, BoundaryLoaderEntry>>;
     /** A Standard Schema validating this route's URL search params. When present, `ctx.search` is parsed +
      * validated against it (failing closed to the schema's defaults on invalid input); type it into the
      * loader with `LoaderArgs<Api, Env, typeof searchSchema>`. */
@@ -232,6 +315,30 @@ export interface RouteModule {
      * island-hydrated pages where interactivity is mounted by smaller, explicit client entries.
      */
     readonly hydrate?: boolean;
+    /**
+     * `false` renders this route's component in the browser only. The server still matches the route,
+     * runs its gates and loaders, renders the layouts around it and embeds the data - it skips the
+     * component alone, putting {@link HydrateFallback} (or nothing) in the page slot. The browser
+     * hydrates against that, then renders the component. For a component that cannot render on a
+     * server: one that reads `window` or a browser-only API while it renders.
+     *
+     * The module itself is still imported on the server, for its loader and options - so an import
+     * that needs a browser at load time belongs inside the component (a dynamic `import()`), not at the
+     * top of the file. Cannot be combined with `hydrate = false`: nothing would ever render the page.
+     */
+    readonly ssr?: boolean;
+    /**
+     * What the server renders in the page slot of an `ssr = false` route, and what the browser hydrates
+     * before the component takes over - a skeleton, a spinner. Receives the same props as the
+     * component, loader `data` included. Omitted ⇒ the slot is empty until the component renders.
+     */
+    readonly HydrateFallback?: unknown;
+    /**
+     * Any value to report through `useMatches` - a breadcrumb label, a render function, a flag a layout
+     * reads about the page inside it. Layouts, pages, and status pages may export one. It is read from
+     * the module on the server and in the browser, so it must be the same value on both.
+     */
+    readonly handle?: unknown;
     /**
      * Opt a **static** route (no `:param`/`*`) into build-time prerendering (SSG): `prerenderRoutes`
      * (from `@nifrajs/web/build`) renders it to a static `index.html` at build. The loader runs at build
@@ -252,8 +359,12 @@ export interface RouteModule {
      * list the client parses to refetch - so the two channels never alias.)
      */
     readonly revalidate?: number;
-    /** Optional bounded tags used by ISR on-demand invalidation (`?tag=...`). */
-    readonly revalidateTags?: readonly string[];
+    /**
+     * Bounded tags ISR on-demand invalidation (`?tag=...`) and a CDN purge reach this page by. A list, or
+     * a function of the route's params and URL (`({ params }) => [\`product:${params.id}\`]`) for tags
+     * per page. Tags travel to the CDN and reach anyone reading the origin: never put personal data in one.
+     */
+    readonly revalidateTags?: RevalidateTags;
     /**
      * No-framework island bundles (`@nifrajs/web/islands`) to load on this route, as `<script
      * type="module">` in the document tail. Loaded **regardless of `hydrate`** - pair with
@@ -262,6 +373,12 @@ export interface RouteModule {
      */
     readonly islandScripts?: readonly string[];
 }
+/** A boundary's server loader, declared in the route's backend half under `boundaryLoaders`. */
+export interface BoundaryLoaderEntry {
+    readonly load: NonNullable<BoundaryRegistration["load"]>;
+    /** The boundary data's output schema. Required whenever `load` returns data. */
+    readonly output?: StandardSchemaV1;
+}
 /** A layout (or `_404`/`_error`) entry: its source file (for client codegen) + a lazy loader.
  *
  * A `_layout.tsx` may export `meta` (static {@link Meta} or a function of the loader data + params,
@@ -270,7 +387,11 @@ export interface RouteModule {
  * (`meta`/`link`) concatenate outermost→innermost→page; scalars (`title`) are nearest-wins (the page
  * overrides an inner layout, which overrides an outer one). See `mergeHeads` in `@nifrajs/web`. */
 export interface LayoutEntry {
+    /** The frontend half: the file the browser bundle imports. */
     readonly file: string;
+    /** The backend half (`x.backend.ts`), when the file has one. Server-only: never in a client bundle. */
+    readonly backend?: string;
+    /** Both halves, merged and checked. */
     readonly load: () => Promise<RouteModule>;
 }
 /** One matched route: pattern, nested layout ids (outermost → innermost), source file, loader. */
@@ -288,13 +409,61 @@ export interface RouteEntry {
      * Optional only so hand-built test manifests may omit it.
      */
     readonly layoutParams?: ReadonlyArray<readonly string[]>;
+    /** `_middleware` ids in this route's ancestor chain (outermost → innermost), run before its
+     * layouts. Absent ⇒ none. */
+    readonly middlewareIds?: readonly string[];
+    /** Param names each middleware in {@link middlewareIds} sees, aligned by index: the params of its
+     * directory's URL prefix, as {@link layoutParams} holds them for a layout. */
+    readonly middlewareParams?: ReadonlyArray<readonly string[]>;
     /** `_error` boundary ids in this route's ancestor chain (outermost → innermost). The last is the
      * **nearest** boundary, rendered when the route's loader throws. Always set by `buildManifest`
      * (optional only so hand-built test manifests may omit it); absent/empty ⇒ no boundary (error 500s). */
     readonly errorIds?: readonly string[];
+    /** Nested `_404` page ids in this route's ancestor chain (outermost → innermost); the root `_404`
+     * is not listed. The last is the **nearest**, rendered when the route's loader answers
+     * `notFound()`. Absent ⇒ the root `_404`. */
+    readonly notFoundIds?: readonly string[];
+    /** `_loading` page ids in this route's ancestor chain (outermost → innermost). A client navigation
+     * to the route shows the innermost one whose layouts are already on screen. Absent ⇒ none. */
+    readonly loadingIds?: readonly string[];
+    /** The frontend half: the file the browser bundle imports. */
     readonly file: string;
+    /** The backend half (`x.backend.ts`), when the route has one. Server-only. */
+    readonly backend?: string;
+    /** Both halves, merged and checked. */
     readonly load: () => Promise<RouteModule>;
 }
+/** One URL pattern a nested `_404` answers when no route matches it. */
+export interface NotFoundScope {
+    /** The directory's URL prefix (`/admin`) or everything beneath it (`/admin/*`). */
+    readonly pattern: string;
+    /** Param names each layout in {@link NotFoundEntry.layoutIds} owns on this pattern, by index. */
+    readonly layoutParams: ReadonlyArray<readonly string[]>;
+    /** Param names each middleware in {@link NotFoundEntry.middlewareIds} sees on this pattern, by
+     * index. Absent when the page has no middleware. */
+    readonly middlewareParams?: ReadonlyArray<readonly string[]>;
+}
+/** A `_404` page below the routes root. */
+export interface NotFoundEntry extends LayoutEntry {
+    /** Layouts at or above the page's directory (outermost → innermost) - the ones it renders inside. */
+    readonly layoutIds: readonly string[];
+    /** `_error` boundaries at or above the page's directory (outermost → innermost). */
+    readonly errorIds: readonly string[];
+    /** `_middleware` ids at or above the page's directory (outermost → innermost). Absent ⇒ none. */
+    readonly middlewareIds?: readonly string[];
+    /**
+     * The URL patterns this page answers when no route matches. Empty when the directory is a
+     * catch-all, or when a `_404` in a directory above it answers the same URLs - the page is then
+     * reached only by `notFound()` from a route beneath it.
+     */
+    readonly scopes: readonly NotFoundScope[];
+}
+/** A `_loading` page: what the page slot shows while a client navigation loads. */
+export interface LoadingEntry extends LayoutEntry {
+    /** Layouts at or above the page's directory (outermost → innermost). The page shows only while
+     * every one of them is on screen, so it never renders outside a layout above it. */
+    readonly layoutIds: readonly string[];
+}
 /** The full route manifest. */
 export interface Manifest {
     readonly routes: readonly RouteEntry[];
@@ -302,13 +471,51 @@ export interface Manifest {
     /** Per-segment `_error` boundary components, keyed by id (`_error`, `a/_error`, …). Always set by
      * `buildManifest` (optional only so hand-built test manifests may omit it). */
     readonly errors?: Readonly<Record<string, LayoutEntry>>;
+    /** The `_404` at the routes root: unmatched URLs and `notFound()` wherever no nested one applies. */
     readonly notFound?: LayoutEntry;
+    /**
+     * `_404` pages below the routes root, keyed by id (`admin/_404`, …). Each answers `notFound()` from
+     * the routes beneath its directory and the unmatched URLs under that directory's URL prefix, and
+     * renders inside the layouts at or above it. Absent when the app has none.
+     */
+    readonly notFounds?: Readonly<Record<string, NotFoundEntry>>;
     /** Per-status terminal pages from `_<status>.tsx` at the routes root (`_410`, `_451`, …), keyed by
      * the status as a string. Rendered by a loader's `gone()` / `statusPage(n)`; a status with no page
      * falls back to `_404`, and then to plain text. `_404` itself stays on {@link notFound} - it is
      * reached by unmatched paths too, which these are not. */
     readonly statusPages?: Readonly<Record<string, LayoutEntry>>;
+    /**
+     * `_loading` pages, keyed by id (`_loading`, `admin/_loading`, …). A client navigation that is
+     * still loading after a short delay shows the target route's nearest one in the page slot, inside
+     * the layouts the two pages share. Browser-only: the server never renders one. Absent when the app
+     * has none.
+     */
+    readonly loadings?: Readonly<Record<string, LoadingEntry>>;
+    /**
+     * Middleware candidates, keyed by id (`_middleware`, `admin/_middleware`, …): one per directory
+     * with a `_layout.backend.ts`, whose `middleware` export each loads as `default` (`undefined` when
+     * that file exports none). Server-only: the client build never imports one. Absent when no
+     * directory has a layout backend half.
+     */
+    readonly middlewares?: Readonly<Record<string, LayoutEntry>>;
 }
+/** Whether a routes-relative path is a retired `_middleware` module. Discovery collects it only so
+ * that {@link buildManifest} can refuse it with the migration. */
+export declare const isMiddlewareFile: (file: string) => boolean;
+/** Whether a routes-relative path is a route's backend half (`x.backend.ts`). */
+export declare const isRouteBackendFile: (file: string) => boolean;
+/** The backend half a frontend route file pairs with: `blog/[slug].tsx` -> `blog/[slug].backend.ts`. */
+export declare const backendFileFor: (file: string) => string;
+/** Exports the browser runs or reads. They live in a route's frontend file, which ships whole. */
+export declare const FRONTEND_ROUTE_EXPORTS: ReadonlySet<string>;
+/** Exports only the server or the build reads. They live in the route's `x.backend.ts`. */
+export declare const BACKEND_ROUTE_EXPORTS: ReadonlySet<string>;
+/**
+ * Merge a route's two halves into the one {@link RouteModule} the server runs, refusing any export on
+ * the wrong side. The checks run on every server, dev and production alike, so a misplaced `loader`
+ * fails the first request to its route even before a client build has looked at it.
+ */
+export declare function mergeRouteHalves(file: string, front: RouteModule, backend: string | undefined, back: Readonly<Record<string, unknown>> | undefined): RouteModule;
 export declare function filePathToPatterns(file: string): string[];
 /** One URL pattern a route file expands to, plus the scope information layouts need. */
 export interface FileRoutePattern {
@@ -338,8 +545,8 @@ export declare function filePathToPattern(file: string): string;
 /**
  * Build a manifest from route file paths (relative to the routes dir) + an `importer` that
  * turns a path into a lazy module loader. Pure - no fs. Throws at boot (the loud-and-early
- * RouteConfigError ethos) on duplicate patterns. `_layout`/`_404`/`_error` files are special; other
- * `_`-prefixed files are ignored (private/colocated, never routed).
+ * RouteConfigError ethos) on duplicate patterns. `_layout`/`_404`/`_error`/`_loading`/`_middleware`
+ * files are special; other `_`-prefixed files are ignored (private/colocated, never routed).
  */
 export declare function buildManifest(files: readonly string[], importer: (file: string) => () => Promise<RouteModule>): Manifest;
 /**

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAE7E;2GAC2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,mGAAmG;IACnG,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB;yGACqG;IACrG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB;;iEAE6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC;AAED,mEAAmE;AACnE,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEvE,qGAAqG;AACrG,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhE,wGAAwG;AACxG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C;AAED,qGAAqG;AACrG,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEjF,2GAA2G;AAC3G,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CACjC;AAED,oGAAoG;AACpG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,gBAAgB,KACnB,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;AAEnE,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,sGAAsG;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACpD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,EAAE,IAAI,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAA;CACtD;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,IAAI,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAA;CACtD;AAED;;;;;iCAKiC;AACjC,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG,kBAAkB,CAAA;AAExE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;IAC/B,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAAA;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC7C,sGAAsG;IACtG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACzD;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,IAAI,GAAG,OAAO;IACtC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;4FAE4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAA;AAEzD,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CAClC;AAED,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAErE,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD;;kEAE8D;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1E;;;;qGAIiG;IACjG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C;AAED;;;;;;mGAMmG;AACnG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;CAC1C;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IACxD;;4GAEwG;IACxG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;CAC1C;AAED,+BAA+B;AAC/B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACvD;mFAC+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAC/B;;;8DAG0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;CAC7D;AA0FD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAmCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,OAAO,CAAC,WAAW,CAAC,GACrD,QAAQ,CAgEV;AAYD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAWrC;AAED;8EAC8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;IACxB;yGACqG;IACrG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;CAClD;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBhG"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAClE,kFAAkF;IAClF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAA;CACnF;AAED;2GAC2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,mGAAmG;IACnG,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB;yGACqG;IACrG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB;;iEAE6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,sBAAsB,CAAA;CACrC;AAED,mEAAmE;AACnE,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,CAAC,GAAG,GAAG,aAAa,IAAI,CACjD,GAAG,EAAE,GAAG,KACL,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAEnD,uGAAuG;AACvG,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAA;AAErE,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAA;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACxD,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACrD,6FAA6F;IAC7F,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAA;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAA;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEvE,qGAAqG;AACrG,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhE,wGAAwG;AACxG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C;AAED,qGAAqG;AACrG,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEjF,2GAA2G;AAC3G,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CACjC;AAED,oGAAoG;AACpG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,gBAAgB,KACnB,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAA;AAE7E,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC;mFAC+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC,CAAA;CACzE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,EAAE,IAAI,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAA;CACtD;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,IAAI,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAA;CACtD;AAED;;;;;iCAKiC;AACjC,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG,kBAAkB,CAAA;AAExE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;IAC/B,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAAA;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC7C,sGAAsG;IACtG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACzD;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,IAAI,GAAG,OAAO;IACtC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;4FAE4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAA;AAEzD,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CAClC;AAED,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAErE,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAA;IACxC,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAA;IACxC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC;;4CAEwC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAA;IACxE;;kEAE8D;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1E;;;;qGAIiG;IACjG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C;AAED,gGAAgG;AAChG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAA;IACxD,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CACnC;AAED;;;;;;mGAMmG;AACnG,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;CAC1C;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IACxD;iCAC6B;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;kFAC8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IAC5D;;4GAEwG;IACxG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC;;iDAE6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC;kGAC8F;IAC9F,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;CAC1C;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,iGAAiG;IACjG,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IACvD;wDACoD;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;CAC7D;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,qGAAqG;IACrG,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,iGAAiG;IACjG,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;CAC1C;AAED,mFAAmF;AACnF,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C;wFACoF;IACpF,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED,+BAA+B;AAC/B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACvD;mFAC+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACvD,qGAAqG;IACrG,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;IAC5D;;;8DAG0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IAC5D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;CAC7D;AA+BD;kEACkE;AAClE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAA+C,CAAA;AAE/F,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OAA6C,CAAA;AAE/F,wGAAwG;AACxG,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAAwC,CAAA;AAEtF,kGAAkG;AAClG,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAWrD,CAAA;AAEF,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAepD,CAAA;AAqDF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GAClD,WAAW,CAgFb;AAoFD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AA2CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,OAAO,CAAC,WAAW,CAAC,GACrD,QAAQ,CAoSV;AAYD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAWrC;AAED;8EAC8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;IACxB;yGACqG;IACrG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;CAClD;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBhG"}