@webflow/cloud-app 0.1.0-beta.7

package/dist/frameworks/nextjs/index.js

@@ -0,0 +1,268 @@
+"use strict";
+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.NextJsBuilder = void 0;
+/**
+ * Next.js Framework Builder
+ *
+ * Builds Next.js projects for Cloudflare Workers deployment using
+ * @opennextjs/cloudflare.
+ *
+ * - Requires @opennextjs/cloudflare
+ * - Build command: opennextjs-cloudflare build
+ * - Build output: .open-next/assets (static) + .open-next/worker.js (worker)
+ */
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+const base_1 = require("../base");
+const errors_1 = require("../errors");
+const utils_1 = require("../../utils");
+const adapter_resolver_1 = require("./adapter-resolver");
+/** Base path for Next.js templates. */
+const TEMPLATE_BASE = path.join(__dirname, 'templates');
+class NextJsBuilder extends base_1.FrameworkBuilder {
+    static frameworkName = 'nextjs';
+    // ───────────────────────────────────────────────────────────────────────────
+    // FRAMEWORK INFO
+    // ───────────────────────────────────────────────────────────────────────────
+    get info() {
+        return {
+            name: 'nextjs',
+            version: '*',
+            displayName: 'Next.js',
+            packageName: 'next',
+        };
+    }
+    getFrameworkVersion() {
+        return this.resolveFrameworkVersion('next');
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // DETECTION
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Detect if this is a Next.js project.
+     */
+    static detect(packageJson, webflowJson) {
+        const specifiedFramework = webflowJson?.cloud?.framework;
+        if (specifiedFramework === 'nextjs') {
+            return { detected: true, reason: 'Specified as nextjs in webflow.json' };
+        }
+        // If webflow.json specifies a DIFFERENT framework, don't match.
+        if (specifiedFramework && specifiedFramework !== 'nextjs') {
+            return { detected: false };
+        }
+        const hasNext = packageJson.dependencies?.next !== undefined ||
+            packageJson.devDependencies?.next !== undefined;
+        if (hasNext) {
+            return { detected: true, reason: 'Found "next" in package.json' };
+        }
+        return { detected: false };
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // VALIDATION
+    // ───────────────────────────────────────────────────────────────────────────
+    async validate() {
+        const { log, packageJson } = this.ctx;
+        const nextVersion = packageJson.dependencies?.next || packageJson.devDependencies?.next;
+        if (!nextVersion) {
+            throw new errors_1.FrameworkValidationError('Next.js is not installed in this project.', {
+                remediation: 'Install Next.js by running: npm install next',
+                documentationUrl: 'https://nextjs.org/docs/getting-started/installation',
+            });
+        }
+        log.info(`Validated Next.js project: next@${nextVersion}`);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // DEPENDENCIES
+    // ───────────────────────────────────────────────────────────────────────────
+    getCloudflareAdapter() {
+        return {
+            name: '@opennextjs/cloudflare',
+            // Fallback used only when a compatible version can't be resolved from the
+            // user's Next.js pin; installDependencies() normally pins an exact version.
+            version: '*',
+        };
+    }
+    getRequiredIntegrations() {
+        // No additional integrations required.
+        return [];
+    }
+    async installDependencies() {
+        const { log, cwd, runCommand } = this.ctx;
+        const adapter = this.getCloudflareAdapter();
+        // Respect an adapter version the user already pinned — don't second-guess it.
+        if (this.hasDependency(adapter.name)) {
+            return;
+        }
+        log.warn(`nextjs integration requires ${adapter.name} and this project doesn't have it. installing now...`);
+        // Pin the adapter to a release whose `next` peer range accepts the user's
+        // pinned Next.js, avoiding npm ERESOLVE peer-dependency dead zones. A null
+        // result means the Next.js version couldn't be determined — fall back to the
+        // latest adapter (prior behaviour); a genuinely incompatible Next.js throws.
+        const nextSpec = this.getDependencyVersion('next') ?? '';
+        const resolvedVersion = await (0, adapter_resolver_1.resolveCompatibleAdapterVersion)(log, adapter.name, nextSpec, cwd);
+        const args = resolvedVersion === null
+            ? ['install', '--save', adapter.name]
+            : ['install', '--save', '--save-exact', `${adapter.name}@${resolvedVersion}`];
+        await (0, utils_1.npm)({ log, runCommand, cwd, args });
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // CONFIGURATION
+    // ───────────────────────────────────────────────────────────────────────────
+    getWebflowLoader() {
+        return {
+            templatePath: path.join(TEMPLATE_BASE, 'webflow-loader.ts'),
+            destinationName: 'webflow-loader.ts',
+            configPath: './webflow-loader.ts',
+        };
+    }
+    getUserConfigPatterns() {
+        return ['next.config.mjs', 'next.config.cjs', 'next.config.js', 'next.config.ts'];
+    }
+    getWranglerTemplatePath() {
+        return path.join(TEMPLATE_BASE, 'wrangler.json');
+    }
+    getAdditionalConfigFiles() {
+        const loader = this.getWebflowLoader();
+        return [loader.templatePath, path.join(TEMPLATE_BASE, 'open-next.config.ts')];
+    }
+    /** Checks if open-next.config.ts exists. */
+    findOpenNextConfig() {
+        const filename = 'open-next.config.ts';
+        if (fs.existsSync(path.join(this.cwd, filename))) {
+            return filename;
+        }
+        return undefined;
+    }
+    /**
+     * Ensures open-next.config.ts exists.
+     * - If it exists: leave it alone for opennextjs-cloudflare to validate.
+     * - If missing: create it from the template.
+     */
+    ensureOpenNextConfig(templatePath) {
+        const { log, cwd } = this.ctx;
+        const existingConfig = this.findOpenNextConfig();
+        if (existingConfig) {
+            log.info(`${existingConfig} found, skipping creation (opennextjs-cloudflare will validate)`);
+            return;
+        }
+        log.info('open-next.config not found, creating open-next.config.ts with default Webflow Cloud configuration...');
+        if (!fs.existsSync(templatePath)) {
+            throw new Error(`open-next.config.ts template not found at ${templatePath}. This is a Webflow Cloud build system error.`);
+        }
+        const configPath = path.join(cwd, 'open-next.config.ts');
+        fs.copyFileSync(templatePath, configPath);
+        log.info('open-next.config.ts created successfully');
+    }
+    async prepareConfig() {
+        const { log, cwd, userEnv } = this.ctx;
+        // Rename user's next.config.* to clouduser.next.config.*; if there is no
+        // user config, write an empty stub so the generated template's static
+        // import always resolves.
+        const renamedUserConfig = (0, utils_1.renameUserConfig)(log, cwd, 'next.config', ['mjs', 'cjs', 'js', 'ts']);
+        if (renamedUserConfig === null) {
+            log.info('no user next.config.{mjs,cjs,js,ts} found — writing empty clouduser.next.config.ts stub');
+            fs.writeFileSync(path.join(cwd, 'clouduser.next.config.ts'), 'export default {};\n');
+        }
+        else if (path.extname(renamedUserConfig) !== '.ts') {
+            // Next.js 16 type-checks next.config.ts with tsc, whose default module
+            // resolution can't find `.mjs`/`.cjs`/`.js` siblings of an extensionless
+            // import. Write a type-only shim so tsc resolves the import; runtime
+            // resolution is handled by Next.js's TS config loader and ignores .d.ts.
+            log.info(`writing clouduser.next.config.d.ts shim for ${path.basename(renamedUserConfig)}`);
+            fs.writeFileSync(path.join(cwd, 'clouduser.next.config.d.ts'), "import type { UserNextConfig } from './next.config.webflow';\ndeclare const config: UserNextConfig;\nexport default config;\n");
+        }
+        // Copy the merge-logic library (real source, not a template).
+        const webflowConfigSrc = path.join(TEMPLATE_BASE, 'next.config.webflow.ts');
+        if ((0, utils_1.fileExists)(webflowConfigSrc)) {
+            log.info('Copying next.config.webflow.ts...');
+            fs.copyFileSync(webflowConfigSrc, path.join(cwd, 'next.config.webflow.ts'));
+        }
+        // Render the single next.config.ts template.
+        const templatePath = path.join(TEMPLATE_BASE, 'next.config.ts.template');
+        const destPath = path.join(cwd, 'next.config.ts');
+        log.info('Generating next.config.ts from template...');
+        await (0, utils_1.envsubst)(log, templatePath, destPath, {
+            ...process.env,
+            ...userEnv,
+        });
+        // Copy webflow-loader.ts.
+        const loader = this.getWebflowLoader();
+        if ((0, utils_1.fileExists)(loader.templatePath)) {
+            log.info(`Copying ${loader.destinationName}...`);
+            fs.copyFileSync(loader.templatePath, path.join(cwd, loader.destinationName));
+        }
+        // Ensure open-next.config.ts exists.
+        this.ensureOpenNextConfig(path.join(TEMPLATE_BASE, 'open-next.config.ts'));
+        // wrangler.json is owned exclusively by `handleWranglerJson`, which runs
+        // before this hook and is the only function permitted to write
+        // /wrangler.json. Copying the framework template here would clobber its
+        // user-binding merge.
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // BUILD
+    // ───────────────────────────────────────────────────────────────────────────
+    getBuildCommand() {
+        return 'opennextjs-cloudflare build';
+    }
+    getNodeVersionRequirement() {
+        return {
+            minimum: '18.0.0',
+            severity: 'error',
+        };
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // OUTPUT
+    // ───────────────────────────────────────────────────────────────────────────
+    static getOutputDeployMetadata() {
+        return {
+            staticAssetsPath: '.open-next/assets',
+            workerEntryPath: '.open-next/worker.js',
+            deploymentType: 'ssr',
+            // After wrangler dry-run, the bundled output is ./worker.js
+            dryRunEntryPath: './worker.js',
+        };
+    }
+    /**
+     * 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) {
+        return fs.statSync(path.join(cwd, './worker.js'), { throwIfNoEntry: false })?.isFile() ?? false;
+    }
+}
+exports.NextJsBuilder = NextJsBuilder;
+//# sourceMappingURL=index.js.map

package/dist/frameworks/nextjs/index.js.map

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

package/dist/frameworks/nextjs/templates/next.config.ts.template

@@ -0,0 +1,13 @@
+// Generated by the Webflow Cloud builder. Merge logic lives in ./next.config.webflow.ts.
+import userConfig from './clouduser.next.config';
+import { withWebflowOverrides } from './next.config.webflow';
+
+// Next.js disallows '/' as basePath, so '/' maps to ''.
+const mountPath: string = '${COSMIC_MOUNT_PATH}';
+export const webflowBasePath = mountPath === '/' ? '' : mountPath;
+export const webflowAssetPrefix = '${COSMIC_DEPLOY_URL}' + webflowBasePath;
+
+export default withWebflowOverrides(userConfig, {
+  basePath: webflowBasePath,
+  assetPrefix: webflowAssetPrefix,
+});

package/dist/frameworks/nextjs/templates/next.config.webflow.ts

@@ -0,0 +1,46 @@
+// Merge logic for the generated next.config.ts. Copied verbatim into the
+// user's project; types are local to avoid Next.js cross-version drift.
+import type { NextConfig } from 'next';
+
+type NextConfigContext = { defaultConfig: NextConfig };
+type UserNextConfigFn = (phase: string, ctx: NextConfigContext) => NextConfig | Promise<NextConfig>;
+
+export type UserNextConfig = NextConfig | UserNextConfigFn;
+export type WebflowOverridesOptions = { basePath: string; assetPrefix: string };
+
+/**
+ * Wrap the user's Next.js config with Webflow Cloud's required overrides.
+ * `userExport` is always provided — `{}` when the user ships no next.config.
+ */
+export function withWebflowOverrides(
+  userExport: UserNextConfig,
+  opts: WebflowOverridesOptions,
+): UserNextConfigFn {
+  return async function nextConfig(phase: string, ctx: NextConfigContext): Promise<NextConfig> {
+    const resolved = await resolveUserConfig(userExport, phase, ctx);
+    return {
+      ...resolved,
+      basePath: opts.basePath,
+      assetPrefix: opts.assetPrefix,
+      images: {
+        ...resolved.images,
+        // TODO: support non-custom loaders (imgix, cloudinary, akamai) if they work
+        loader: 'custom',
+        loaderFile: resolved.images?.loaderFile || './webflow-loader.ts',
+      },
+    };
+  };
+}
+
+async function resolveUserConfig(
+  userExport: UserNextConfig,
+  phase: string,
+  ctx: NextConfigContext,
+): Promise<NextConfig> {
+  if (typeof userExport === 'function') {
+    return (await userExport(phase, ctx)) ?? {};
+  }
+  // `export default null` is rare but not impossible; guard so the spread in
+  // withWebflowOverrides can't NPE.
+  return userExport ?? {};
+}

package/dist/frameworks/nextjs/templates/open-next.config.ts

@@ -0,0 +1,3 @@
+import { defineCloudflareConfig } from '@opennextjs/cloudflare';
+
+export default defineCloudflareConfig();

package/dist/frameworks/nextjs/templates/webflow-loader.ts

@@ -0,0 +1,44 @@
+import { webflowAssetPrefix, webflowBasePath } from './next.config';
+
+const basePath = webflowBasePath;
+const assetPrefix = webflowAssetPrefix || basePath;
+
+function normalizeSrc(src: string) {
+  // For local assets, include the base path but not the asset prefix
+  if (assetPrefix && src.startsWith(assetPrefix)) {
+    return `${basePath}${src.slice(assetPrefix.length)}`;
+  } else if (basePath && src.startsWith(basePath)) {
+    return src;
+  } else if (src.startsWith('/')) {
+    return basePath + src;
+  }
+  return src;
+}
+
+export default function cloudflareLoader({
+  src,
+  width,
+  quality,
+}: {
+  src: string;
+  width: number;
+  quality?: number;
+}) {
+  const normalizedSrc = normalizeSrc(src);
+
+  // Our cloudflare zone doesn't allow optimizing external images for security reasons, so just load the original image
+  // For now, also skip optimization for images hosted on regular webflow sites (cdn.website-files.com)
+  // because optimizing them would result in two bandwidth charges: one from the website-files zone (for the full image)
+  // and one from the cosmic.webflow.services zone (for the resized image)
+  if (normalizedSrc.startsWith('http://') || normalizedSrc.startsWith('https://')) {
+    return normalizedSrc;
+  }
+
+  const params = [`width=${width}`];
+  if (quality) {
+    params.push(`quality=${quality}`);
+  }
+  const paramsString = params.join(',');
+  const workerUrl = basePath ? assetPrefix.slice(0, -basePath.length) : assetPrefix;
+  return `${workerUrl}/cdn-cgi/image/${paramsString}${normalizedSrc}`;
+}

package/dist/frameworks/nextjs/templates/wrangler.json

@@ -0,0 +1,6 @@
+{
+  "name": "cosmic-builder-dry-run",
+  "main": ".open-next/worker.js",
+  "compatibility_date": "2025-03-03",
+  "compatibility_flags": ["nodejs_compat"]
+}

package/dist/frameworks/registry.d.ts

@@ -0,0 +1,127 @@
+import type { BuildContext, BuildOutput, PackageJson, WebflowJson, DetectionResult } from './types';
+import { FrameworkBuilder } from './base';
+/** Type for a builder class with static detect method. */
+export interface BuilderClass {
+    /** Canonical framework name (e.g. 'nextjs', 'astro', 'vite'). */
+    frameworkName: string;
+    detect(packageJson: PackageJson, webflowJson?: WebflowJson): DetectionResult;
+    detectFromBuiltOutput(cwd: string): boolean;
+    getOutputDeployMetadata(): BuildOutput;
+    new (ctx: BuildContext): FrameworkBuilder;
+}
+/** Detection result with the matched builder. */
+export interface DetectionMatch {
+    Builder: BuilderClass;
+    result: DetectionResult;
+}
+/**
+ * All registered framework builders, in detection order.
+ *
+ * IMPORTANT: Order matters — first match wins. More specific frameworks must
+ * come before generic ones.
+ *
+ * - Astro 7 before Astro 6 before Astro 5 (version-specific, newest first)
+ * - Next.js before Vite (uses Vite internally)
+ * - Vite before Static (Vite catches generic Vite SPAs)
+ * - Static last: matches only an explicit `framework: "static"` here; implicit
+ *   no-framework detection is a filesystem fallback the host resolves via
+ *   `resolveIsStaticApp` before calling into detection.
+ */
+export declare const FRAMEWORK_BUILDERS: BuilderClass[];
+/**
+ * Allowed framework names for webflow.json. Single source of truth is the
+ * deploy contract's `Framework` enum — what's deployable is what's allowed.
+ *
+ * Note: Astro version (5 vs 6) is detected automatically from package.json.
+ * Users should always specify 'astro', not 'astro5' or 'astro6'.
+ */
+export declare const ALLOWED_FRAMEWORKS: ["astro", "nextjs", "vite", "static"];
+export type AllowedFramework = (typeof ALLOWED_FRAMEWORKS)[number];
+/**
+ * Detect which framework builder should handle this project. First-match-wins;
+ * order in FRAMEWORK_BUILDERS determines precedence.
+ *
+ * @returns The first matching builder class, or null if no match.
+ */
+export declare function detectFrameworkBuilder(packageJson: PackageJson, webflowJson?: WebflowJson): DetectionMatch | null;
+/**
+ * Detect which framework produced the build artifacts in `cwd`.
+ *
+ * Used at deploy time when webflow.json may not have been written by the
+ * producer. Iterates registered builders and returns the first one whose
+ * `detectFromBuiltOutput` recognizes the output. Returns null if none match.
+ */
+export declare function detectFrameworkFromBuiltOutput(cwd: string): BuilderClass | null;
+/**
+ * Detect and create the appropriate framework builder.
+ *
+ * @throws FrameworkDetectionError if no framework can be detected
+ */
+export declare function detectAndCreateBuilder(ctx: BuildContext, webflowJson?: WebflowJson): FrameworkBuilder;
+/**
+ * Decide whether a project is a no-framework static app.
+ *
+ * Two ways in:
+ *   - **explicit**: webflow.json declares `framework: "static"`. This wins
+ *     unconditionally — even with a package.json present — so the explicit
+ *     opt-in is honored ahead of the package/index guard in the build flow.
+ *   - **inferred (zero-config)**: no package.json, a real `index.html` file at
+ *     the root, no *other* framework explicitly declared, and **no runtime/build
+ *     indicators** (`hasRuntimeIndicators`). `index.html` + no package.json is
+ *     only a preflight signal; a repo that also ships a build/server manifest
+ *     (requirements.txt, composer.json, Gemfile, Dockerfile, …) is a mixed
+ *     static+runtime repo and must NOT be silently published — the caller
+ *     rejects that case. The caller resolves `hasRootIndexHtmlFile` with a
+ *     regular-file check (not `existsSync`), so a directory or symlink named
+ *     `index.html` does not trigger inference.
+ */
+export declare function resolveIsStaticApp(params: {
+    hasPackageJson: boolean;
+    specifiedFramework?: string;
+    hasRootIndexHtmlFile: boolean;
+    hasRuntimeIndicators: boolean;
+}): boolean;
+/**
+ * Resolve whether `cwd` is a no-framework static app, doing the filesystem
+ * checks that `resolveIsStaticApp` needs: a regular-file root index.html and a
+ * recursive scan for runtime indicators. This is the single implementation both
+ * producers (cosmic-builder, webflow-cli) call, so static detection is
+ * identical everywhere.
+ *
+ * `index.html` + no package.json is only a preflight signal: a repo that also
+ * ships a build/server manifest is a mixed static+runtime repo whose source
+ * must not be silently published as assets. On the inference path (no explicit
+ * framework) such a repo is rejected loudly, naming the offending files. An
+ * explicit `framework: "static"` is honored even when those files are present.
+ *
+ * Requires a regular file for the inferred index.html (lstat, not existsSync)
+ * so a directory or symlink named index.html can't trigger inference.
+ *
+ * @throws FrameworkDetectionError for a mixed static+runtime repo on inference.
+ */
+export declare function detectStaticApp(cwd: string, packageJson: PackageJson | undefined, webflowJson?: WebflowJson): {
+    isStatic: boolean;
+};
+/**
+ * Read the customer's installed major version of a framework's primary npm
+ * package. Used only for metric tagging.
+ *
+ * `getMajorVersion` is defensive on empty/non-semver input (dist-tags, git
+ * URLs, 'workspace:*', etc.), so the 'unknown' fallback is unreachable in the
+ * normal path — kept for resilience to silent dep-tree changes.
+ */
+export declare function getCustomerMajorVersion(packageName: string, packageJson: PackageJson): string;
+/**
+ * Validate that a framework name from webflow.json is supported.
+ *
+ * @throws FrameworkDetectionError if framework is not supported
+ */
+export declare function validateFrameworkName(frameworkName: string): asserts frameworkName is AllowedFramework;
+export { Astro5Builder, Astro6Builder, Astro7Builder } from './astro';
+export { NextJsBuilder } from './nextjs';
+export { ViteBuilder } from './vite';
+export { StaticBuilder } from './static';
+export { FrameworkBuilder } from './base';
+export * from './types';
+export * from './errors';
+//# sourceMappingURL=registry.d.ts.map

package/dist/frameworks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/frameworks/registry.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAa1C,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IAC7E,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5C,uBAAuB,IAAI,WAAW,CAAC;IACvC,KAAK,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAAC;CAC3C;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACzB;AAMD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAAY,EAO5C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,uCAAoB,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMnE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc,GAAG,IAAI,CAQvB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAO/E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,YAAY,EACjB,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB,CAiBlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CASV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,WAAW,CAAC,EAAE,WAAW,GACxB;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAkCvB;AAMD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAK7F;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,IAAI,gBAAgB,CAM3C;AAMD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}