@webflow/cloud-app 0.1.0-beta.7

package/dist/frameworks/errors.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Custom error types for framework builders.
+ *
+ * These errors carry remediation hints, documentation links, and
+ * framework-specific context so hosts can render actionable failures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameworkDetectionError = exports.FrameworkConfigError = exports.FrameworkBuildError = exports.FrameworkValidationError = exports.FrameworkError = void 0;
+/**
+ * Base error for all framework-related errors.
+ * Includes optional remediation hints and documentation links.
+ */
+class FrameworkError extends Error {
+    remediation;
+    documentationUrl;
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.name = 'FrameworkError';
+        this.cause = options?.cause;
+        this.remediation = options?.remediation;
+        this.documentationUrl = options?.documentationUrl;
+        // Maintains proper stack trace for where error was thrown (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Format the error for display, including remediation if available.
+     */
+    toDisplayString() {
+        let result = this.message;
+        if (this.remediation) {
+            result += `\n\nHow to fix: ${this.remediation}`;
+        }
+        if (this.documentationUrl) {
+            result += `\n\nDocumentation: ${this.documentationUrl}`;
+        }
+        return result;
+    }
+}
+exports.FrameworkError = FrameworkError;
+// ─────────────────────────────────────────────────────────────────────────────
+// Validation Error
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Thrown when project validation fails.
+ *
+ * Examples:
+ * - Wrong Node.js version
+ * - Missing required dependencies
+ * - Invalid configuration
+ * - Unsupported framework version
+ */
+class FrameworkValidationError extends FrameworkError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'FrameworkValidationError';
+    }
+}
+exports.FrameworkValidationError = FrameworkValidationError;
+/**
+ * Thrown when the build command fails.
+ * Includes framework-specific debugging hints.
+ */
+class FrameworkBuildError extends FrameworkError {
+    buildCommand;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'FrameworkBuildError';
+        this.buildCommand = options?.buildCommand;
+    }
+    toDisplayString() {
+        let result = super.toDisplayString();
+        if (this.buildCommand) {
+            result += `\n\nBuild command: ${this.buildCommand}`;
+        }
+        return result;
+    }
+}
+exports.FrameworkBuildError = FrameworkBuildError;
+/**
+ * Thrown when configuration is invalid or cannot be processed.
+ *
+ * Examples:
+ * - Malformed astro.config.mjs
+ * - Invalid wrangler.json
+ * - Missing required config fields
+ */
+class FrameworkConfigError extends FrameworkError {
+    configFile;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'FrameworkConfigError';
+        this.configFile = options?.configFile;
+    }
+    toDisplayString() {
+        let result = super.toDisplayString();
+        if (this.configFile) {
+            result += `\n\nConfig file: ${this.configFile}`;
+        }
+        return result;
+    }
+}
+exports.FrameworkConfigError = FrameworkConfigError;
+// ─────────────────────────────────────────────────────────────────────────────
+// Detection Error
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Thrown when framework cannot be detected.
+ */
+class FrameworkDetectionError extends FrameworkError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'FrameworkDetectionError';
+    }
+}
+exports.FrameworkDetectionError = FrameworkDetectionError;
+//# sourceMappingURL=errors.js.map

package/dist/frameworks/errors.js.map

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

package/dist/frameworks/nextjs/adapter-resolver.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Cloudflare adapter version resolution for Next.js.
+ *
+ * `@opennextjs/cloudflare` declares a `next` peer dependency whose range moves
+ * with each release and sometimes carves out "dead zones" — Next.js versions
+ * that are newer than an old floor but excluded by a tighter upper bound (e.g.
+ * peer `>=15.5.18 <16 || >=16.2.6` excludes next@16.0.0–16.2.5). Installing the
+ * adapter with no version constraint always pulls the latest, so an app pinned
+ * inside a dead zone fails with a cryptic npm `ERESOLVE` before the build even
+ * starts.
+ *
+ * This module resolves the concrete Next.js version the app will install and
+ * picks the highest published adapter release whose peer range accepts it,
+ * pinning that version explicitly. When the version cannot be determined it
+ * signals a fallback to the previous "install latest" behaviour; when no
+ * release is compatible it raises an actionable error instead of letting npm
+ * fail opaquely.
+ *
+ * All metadata is read through the app's own npm configuration (`npm view` run
+ * in the app directory), so adapter selection and the subsequent install
+ * resolve against the same registry, scoped registry, and auth.
+ */
+import type { Logger } from '../../ports';
+/** A published adapter version and the Next.js range it declares as a peer. */
+export interface AdapterCandidate {
+    /** Concrete published version, e.g. "1.20.1". */
+    version: string;
+    /** Value of `peerDependencies.next`, or undefined if the version declares none. */
+    nextPeerRange?: string;
+}
+/**
+ * I/O the resolver depends on, injectable so unit tests can run without
+ * touching the network or the `npm` CLI. Both lookups take the app's `cwd` so
+ * they honor its npm configuration (registry, scoped registry, auth) — the same
+ * surface the subsequent install resolves against.
+ */
+export interface AdapterResolverIO {
+    /** Fetch every published adapter version and its `next` peer range. */
+    fetchAdapterCandidates: (adapterName: string, cwd: string) => Promise<AdapterCandidate[]>;
+    /**
+     * Resolve a package.json version spec to the concrete Next.js version npm
+     * would install, or null when it cannot be determined (local/workspace/git
+     * specs, an empty spec, or no matching published version).
+     */
+    resolveInstalledNextVersion: (nextSpec: string, cwd: string) => Promise<string | null>;
+}
+/**
+ * Pick the highest stable adapter version whose declared `next` peer range is
+ * satisfied by `installedNext`.
+ *
+ * Versions that declare no `next` peer dependency are ignored: they predate the
+ * adapter pinning Next.js and silently installing one would mask a real
+ * incompatibility. Prerelease adapter versions are ignored too. Returns null
+ * when nothing matches.
+ */
+export declare function selectAdapterVersion(installedNext: string, candidates: AdapterCandidate[]): string | null;
+/**
+ * Resolve the adapter version to install for a project pinned to `nextSpec`,
+ * reading all metadata through the app's npm config at `cwd`.
+ *
+ * - Returns a concrete version string to pin when a compatible release exists.
+ * - Returns null when the Next.js version can't be determined or the metadata
+ *   lookup fails — the caller should fall back to installing the latest adapter
+ *   (the previous behaviour), which is no worse than before.
+ * - Throws {@link FrameworkValidationError} when the Next.js version is known
+ *   but no published adapter release accepts it, surfacing a clear remediation
+ *   instead of a downstream npm `ERESOLVE`.
+ */
+export declare function resolveCompatibleAdapterVersion(log: Logger, adapterName: string, nextSpec: string, cwd: string, io?: AdapterResolverIO): Promise<string | null>;
+/** Production I/O: `npm view` run in the app's cwd. */
+export declare const defaultAdapterResolverIO: AdapterResolverIO;
+//# sourceMappingURL=adapter-resolver.d.ts.map

package/dist/frameworks/nextjs/adapter-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-resolver.d.ts","sourceRoot":"","sources":["../../../src/frameworks/nextjs/adapter-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAc1C,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC1F;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,gBAAgB,EAAE,GAC7B,MAAM,GAAG,IAAI,CAaf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,EAAE,GAAE,iBAA4C,GAC/C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmDxB;AA2HD,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,EAAE,iBAGtC,CAAC"}

package/dist/frameworks/nextjs/adapter-resolver.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Cloudflare adapter version resolution for Next.js.
+ *
+ * `@opennextjs/cloudflare` declares a `next` peer dependency whose range moves
+ * with each release and sometimes carves out "dead zones" — Next.js versions
+ * that are newer than an old floor but excluded by a tighter upper bound (e.g.
+ * peer `>=15.5.18 <16 || >=16.2.6` excludes next@16.0.0–16.2.5). Installing the
+ * adapter with no version constraint always pulls the latest, so an app pinned
+ * inside a dead zone fails with a cryptic npm `ERESOLVE` before the build even
+ * starts.
+ *
+ * This module resolves the concrete Next.js version the app will install and
+ * picks the highest published adapter release whose peer range accepts it,
+ * pinning that version explicitly. When the version cannot be determined it
+ * signals a fallback to the previous "install latest" behaviour; when no
+ * release is compatible it raises an actionable error instead of letting npm
+ * fail opaquely.
+ *
+ * All metadata is read through the app's own npm configuration (`npm view` run
+ * in the app directory), so adapter selection and the subsequent install
+ * resolve against the same registry, scoped registry, and auth.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAdapterResolverIO = void 0;
+exports.selectAdapterVersion = selectAdapterVersion;
+exports.resolveCompatibleAdapterVersion = resolveCompatibleAdapterVersion;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const semver = __importStar(require("semver"));
+const errors_1 = require("../errors");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Generous stdout cap for `npm view`: the adapter's full metadata (one manifest
+ * per published version) is a few MB and grows as releases accumulate.
+ */
+const NPM_MAX_BUFFER = 32 * 1024 * 1024;
+/** The framework package the adapter declares as a peer dependency. */
+const NEXT_PACKAGE = 'next';
+/**
+ * Pick the highest stable adapter version whose declared `next` peer range is
+ * satisfied by `installedNext`.
+ *
+ * Versions that declare no `next` peer dependency are ignored: they predate the
+ * adapter pinning Next.js and silently installing one would mask a real
+ * incompatibility. Prerelease adapter versions are ignored too. Returns null
+ * when nothing matches.
+ */
+function selectAdapterVersion(installedNext, candidates) {
+    const compatible = candidates
+        .filter((c) => c.nextPeerRange !== undefined)
+        .filter((c) => semver.valid(c.version) !== null && semver.prerelease(c.version) === null)
+        .filter((c) => semver.satisfies(installedNext, c.nextPeerRange, { includePrerelease: false }))
+        .map((c) => c.version);
+    if (compatible.length === 0) {
+        return null;
+    }
+    return compatible.sort(semver.rcompare)[0];
+}
+/**
+ * Resolve the adapter version to install for a project pinned to `nextSpec`,
+ * reading all metadata through the app's npm config at `cwd`.
+ *
+ * - Returns a concrete version string to pin when a compatible release exists.
+ * - Returns null when the Next.js version can't be determined or the metadata
+ *   lookup fails — the caller should fall back to installing the latest adapter
+ *   (the previous behaviour), which is no worse than before.
+ * - Throws {@link FrameworkValidationError} when the Next.js version is known
+ *   but no published adapter release accepts it, surfacing a clear remediation
+ *   instead of a downstream npm `ERESOLVE`.
+ */
+async function resolveCompatibleAdapterVersion(log, adapterName, nextSpec, cwd, io = exports.defaultAdapterResolverIO) {
+    let installedNext;
+    try {
+        installedNext = await io.resolveInstalledNextVersion(nextSpec, cwd);
+    }
+    catch (err) {
+        log.warn(`Could not determine the Next.js version from "${nextSpec}" (${errorMessage(err)}); ` +
+            `installing the latest ${adapterName}.`);
+        return null;
+    }
+    if (installedNext === null || semver.prerelease(installedNext) !== null) {
+        log.info(`Next.js version "${installedNext ?? nextSpec}" is unpinned, a prerelease, or local; ` +
+            `installing the latest ${adapterName}.`);
+        return null;
+    }
+    let candidates;
+    try {
+        candidates = await io.fetchAdapterCandidates(adapterName, cwd);
+    }
+    catch (err) {
+        log.warn(`Could not fetch ${adapterName} versions (${errorMessage(err)}); installing the latest.`);
+        return null;
+    }
+    const selected = selectAdapterVersion(installedNext, candidates);
+    if (selected !== null) {
+        log.info(`Resolved ${adapterName}@${selected} as compatible with next@${installedNext}.`);
+        return selected;
+    }
+    const supported = summarizeSupportedRanges(candidates);
+    // The build's top-level handler logs only `error.message`, so the actionable
+    // guidance must live in the message itself — not just in `remediation`.
+    throw new errors_1.FrameworkValidationError(`No ${adapterName} release is compatible with the installed Next.js version (next@${installedNext}). ` +
+        `Supported Next.js ranges: ${supported}. ` +
+        `Upgrade Next.js to a version within a supported range (e.g. the latest patch of your major), ` +
+        `or add a compatible ${adapterName} version to package.json.`, {
+        remediation: `Upgrade Next.js to a version within a supported range (for example, the latest patch of your major), ` +
+            `or add a compatible "${adapterName}" version to your package.json yourself.`,
+        documentationUrl: 'https://opennext.js.org/cloudflare',
+    });
+}
+/**
+ * Distinct `next` peer ranges across stable adapter releases, newest first,
+ * capped at a few entries — used to make the dead-zone error actionable.
+ */
+function summarizeSupportedRanges(candidates) {
+    const seen = new Set();
+    const ranges = [];
+    const stable = candidates
+        .filter((c) => c.nextPeerRange !== undefined)
+        .filter((c) => semver.valid(c.version) !== null && semver.prerelease(c.version) === null)
+        .sort((a, b) => semver.rcompare(a.version, b.version));
+    for (const c of stable) {
+        const range = c.nextPeerRange;
+        if (!seen.has(range)) {
+            seen.add(range);
+            ranges.push(range);
+        }
+    }
+    return ranges.slice(0, 3).join('; ') || '(none published)';
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Run `npm view <args> --json` in `cwd` and return the parsed JSON (or null). */
+async function npmViewJson(args, cwd) {
+    const { stdout } = await execFileAsync('npm', ['view', ...args, '--json'], {
+        cwd,
+        maxBuffer: NPM_MAX_BUFFER,
+    });
+    const trimmed = stdout.trim();
+    return trimmed === '' ? null : JSON.parse(trimmed);
+}
+/**
+ * Read every published adapter version and its `next` peer range via `npm view`
+ * run in the app's `cwd`, so the metadata comes from the same registry/auth
+ * surface the install uses.
+ *
+ * `npm view <pkg>@>=0.0.0 --json` returns one manifest per published version
+ * (a single object when only one matches) with a stable shape — unlike
+ * field-filtered queries, whose JSON collapses to bare values when some versions
+ * omit the field. Each element redundantly carries the full packument, so the
+ * payload is a few MB; acceptable for this one-time, adapter-absent build step.
+ */
+async function fetchAdapterCandidatesViaNpm(adapterName, cwd) {
+    const parsed = await npmViewJson([`${adapterName}@>=0.0.0`], cwd);
+    const manifests = Array.isArray(parsed)
+        ? parsed
+        : parsed !== null
+            ? [parsed]
+            : [];
+    const candidates = [];
+    for (const manifest of manifests) {
+        if (typeof manifest.version !== 'string') {
+            continue;
+        }
+        const nextPeerRange = manifest.peerDependencies?.[NEXT_PACKAGE];
+        candidates.push({
+            version: manifest.version,
+            nextPeerRange: typeof nextPeerRange === 'string' ? nextPeerRange : undefined,
+        });
+    }
+    return candidates;
+}
+/**
+ * Resolve the concrete Next.js version npm would install for `nextSpec`, using
+ * the app's npm config at `cwd`.
+ *
+ * Exact pins skip the network. Ranges (`^`, `~`, `>=`, …) and dist-tags
+ * (`latest`, `canary`) are resolved with `npm view`. Non-registry specs
+ * (`file:`, `link:`, `workspace:`, `git+…`) make `npm view` exit non-zero; the
+ * caller treats the rejection as "unresolvable" and falls back to installing
+ * the latest adapter.
+ */
+async function resolveInstalledNextVersionViaNpm(nextSpec, cwd) {
+    const spec = nextSpec.trim();
+    if (spec === '') {
+        return null;
+    }
+    if (semver.valid(spec) !== null) {
+        return spec;
+    }
+    const parsed = await npmViewJson([`${NEXT_PACKAGE}@${spec}`, 'version'], cwd);
+    const list = Array.isArray(parsed)
+        ? parsed.filter((v) => typeof v === 'string')
+        : typeof parsed === 'string'
+            ? [parsed]
+            : [];
+    const valid = list.filter((v) => semver.valid(v) !== null);
+    if (valid.length === 0) {
+        return null;
+    }
+    // Mirror npm's default of installing the highest matching version, preferring
+    // a stable release over a prerelease when both match.
+    const stable = valid.filter((v) => semver.prerelease(v) === null);
+    return (stable.length > 0 ? stable : valid).sort(semver.rcompare)[0];
+}
+/** Production I/O: `npm view` run in the app's cwd. */
+exports.defaultAdapterResolverIO = {
+    fetchAdapterCandidates: fetchAdapterCandidatesViaNpm,
+    resolveInstalledNextVersion: resolveInstalledNextVersionViaNpm,
+};
+//# sourceMappingURL=adapter-resolver.js.map

package/dist/frameworks/nextjs/adapter-resolver.js.map

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

package/dist/frameworks/nextjs/index.d.ts

@@ -0,0 +1,38 @@
+import { FrameworkBuilder } from '../base';
+import type { BuildOutput, FrameworkInfo, PackageJson, WebflowJson, DetectionResult, AdapterPackage, IntegrationPackage, WebflowLoaderConfig, NodeVersionRequirement } from '../types';
+export declare class NextJsBuilder extends FrameworkBuilder {
+    static frameworkName: string;
+    get info(): FrameworkInfo;
+    getFrameworkVersion(): string | undefined;
+    /**
+     * Detect if this is a Next.js project.
+     */
+    static detect(packageJson: PackageJson, webflowJson?: WebflowJson): DetectionResult;
+    validate(): Promise<void>;
+    getCloudflareAdapter(): AdapterPackage;
+    getRequiredIntegrations(): IntegrationPackage[];
+    installDependencies(): Promise<void>;
+    getWebflowLoader(): WebflowLoaderConfig;
+    getUserConfigPatterns(): string[];
+    getWranglerTemplatePath(): string;
+    getAdditionalConfigFiles(): string[];
+    /** Checks if open-next.config.ts exists. */
+    private findOpenNextConfig;
+    /**
+     * Ensures open-next.config.ts exists.
+     * - If it exists: leave it alone for opennextjs-cloudflare to validate.
+     * - If missing: create it from the template.
+     */
+    private ensureOpenNextConfig;
+    prepareConfig(): Promise<void>;
+    getBuildCommand(): string;
+    getNodeVersionRequirement(): NodeVersionRequirement | null;
+    static getOutputDeployMetadata(): BuildOutput;
+    /**
+     * Detect Next.js from built output: presence of `./worker.js` (the bundled
+     * entrypoint produced by `opennextjs-cloudflare build`). Mirrors the legacy
+     * fallback the deploy phase used to hardcode.
+     */
+    static detectFromBuiltOutput(cwd: string): boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/frameworks/nextjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frameworks/nextjs/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAQlB,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,OAAgB,aAAa,SAAY;IAMzC,IAAI,IAAI,IAAI,aAAa,CAOxB;IAEQ,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAQlD;;OAEG;WACa,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,eAAe;IA2BtF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/B,oBAAoB,IAAI,cAAc;IAStC,uBAAuB,IAAI,kBAAkB,EAAE;IAKzC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC1C,gBAAgB,IAAI,mBAAmB;IAQvC,qBAAqB,IAAI,MAAM,EAAE;IAIjC,uBAAuB,IAAI,MAAM;IAIjC,wBAAwB,IAAI,MAAM,EAAE;IAKpC,4CAA4C;IAC5C,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAwBtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DpC,eAAe,IAAI,MAAM;IAIzB,yBAAyB,IAAI,sBAAsB,GAAG,IAAI;WAW1C,uBAAuB,IAAI,WAAW;IAUtD;;;;OAIG;WACa,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG5D"}