@nebulr-group/bridge-cli 0.6.6 → 1.0.0-alpha.1

package/dist/commands/flag-init.command.js

@@ -1,463 +0,0 @@
-// TBP-198 — Flags-only integration scaffold.
-//
-// `bridge flag init` (alias for the eventual `bridge init --flags-only`).
-// Detects the project framework from package.json and prints:
-//   - The framework's REAL flag-reading setup snippet
-//   - A `bridge-flags.config.json` next to package.json with appId + baseUrl
-//     + suggested provider config
-//
-// TBP-206 — every snippet below MUST correspond to a symbol that actually
-// exists in the named package at an import specifier that actually resolves.
-// The previous revision invented `createBridgeFlags()` middleware for express,
-// `BridgeFlagsProvider` for react/nextjs and `provideBridgeFlags` for angular,
-// and pointed every framework at a `/flags` subpath — several of which are not
-// declared in the package's `exports` map. Agents followed the scaffold and
-// wrote code that could not resolve, let alone run. If you change a snippet,
-// re-verify it against the package source first.
-//
-// The command is deliberately NON-destructive: it never overwrites source
-// files. The "scaffold" is text output (snippet + config file) for the agent
-// or the developer to apply.
-import { readFile, writeFile, access } from 'node:fs/promises';
-import { join } from 'node:path';
-import { getManagementClient, getResolvedBaseUrl } from '../config.js';
-import { outputSuccess, outputError } from '../output.js';
-export function registerFlagInitCommand(flagParent) {
-    flagParent
-        .command('init')
-        .description('Scaffold a flags-only Bridge integration (no auth setup) — detects framework, prints setup snippet, writes bridge-flags.config.json')
-        .option('--framework <name>', 'Override framework detection: svelte | react | nextjs | angular | nestjs | express')
-        .option('--cwd <path>', 'Project directory (defaults to current)', process.cwd())
-        .option('--no-config', 'Skip writing bridge-flags.config.json')
-        .option('--base-url <url>', 'Override the base URL written to config')
-        .option('--force', 'Overwrite an existing bridge-flags.config.json')
-        .action(async (opts) => {
-        try {
-            const cwd = opts.cwd;
-            const framework = opts.framework ?? (await detectFramework(cwd));
-            const client = getManagementClient();
-            const app = (await client.app.get());
-            const appId = app.id ?? '';
-            const appName = app.name ?? '';
-            // The environment the app was just read from, so the project is wired
-            // to the same one (TBP-708).
-            const baseUrl = opts.baseUrl ?? getResolvedBaseUrl();
-            const snippet = renderSnippet(framework, { appId, baseUrl });
-            let configPath;
-            if (opts.config !== false) {
-                configPath = join(cwd, 'bridge-flags.config.json');
-                // Never clobber a config someone may have edited (TBP-706).
-                if (!opts.force && (await pathExists(configPath))) {
-                    throw new Error(`${configPath} already exists. Pass --force to overwrite it, or --no-config to leave it and only print the setup.`);
-                }
-                await writeFile(configPath, JSON.stringify({
-                    appId,
-                    appName,
-                    baseUrl,
-                    framework,
-                    provider: suggestedProviderConfig(framework),
-                }, null, 2) + '\n', 'utf8');
-            }
-            outputSuccess({
-                framework,
-                app: { id: appId, name: appName },
-                baseUrl,
-                configFile: configPath,
-                nextSteps: nextStepsFor(framework),
-                snippet,
-            });
-        }
-        catch (err) {
-            outputError(err);
-        }
-    });
-}
-// ── Framework detection ─────────────────────────────────────────────────────
-export async function detectFramework(cwd) {
-    const pkgPath = join(cwd, 'package.json');
-    let pkgRaw;
-    try {
-        pkgRaw = await readFile(pkgPath, 'utf8');
-    }
-    catch {
-        return 'unknown';
-    }
-    let pkg;
-    try {
-        pkg = JSON.parse(pkgRaw);
-    }
-    catch {
-        return 'unknown';
-    }
-    const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
-    // Order matters: Next.js + React is detected as Next.js.
-    if ('next' in deps)
-        return 'nextjs';
-    if ('@sveltejs/kit' in deps || 'svelte' in deps)
-        return 'svelte';
-    if ('@nestjs/core' in deps)
-        return 'nestjs';
-    if ('@angular/core' in deps)
-        return 'angular';
-    if ('react' in deps)
-        return 'react';
-    if ('express' in deps)
-        return 'express';
-    return 'unknown';
-}
-export function renderSnippet(framework, ctx) {
-    // Import specifiers that actually resolve for each framework (TBP-206).
-    //
-    //   svelte / react  — declare "./flags" in their package.json `exports` map.
-    //   nextjs          — has NO "./flags" and NO "." key; FF 2.0 is folded into
-    //                     "./client", server-side flags live under "./server".
-    //   angular         — ships a single ng-packagr entry point; everything comes
-    //                     from the bare specifier.
-    //   nestjs          — declares "./flags" since 0.6.0 (TBP-613). Before that
-    //                     it had no `exports` map, so `<pkg>/flags` fell back to
-    //                     legacy resolution and 404'd, and this scaffolder
-    //                     emitted `<pkg>/dist/flags` instead. Reaching into the
-    //                     build directory was never right — it froze the dist
-    //                     layout into a public contract — and generating it here
-    //                     is how the wrong path spread. Requires >= 0.6.0.
-    //   express         — no `exports` map and no flags entry point; the flag
-    //                     surface is on the bare specifier.
-    const pkgFor = {
-        svelte: '@nebulr-group/bridge-svelte/flags',
-        react: '@nebulr-group/bridge-react/flags',
-        nextjs: '@nebulr-group/bridge-nextjs/client',
-        angular: '@nebulr-group/bridge-angular',
-        nestjs: '@nebulr-group/bridge-nestjs/flags',
-        express: '@nebulr-group/bridge-express',
-    };
-    if (framework === 'unknown') {
-        return [
-            `# Bridge Flags — generic setup`,
-            ``,
-            `Couldn't auto-detect your framework. Use the core SDK directly:`,
-            ``,
-            '```ts',
-            `import { BridgeFlags } from '@nebulr-group/bridge-auth-core';`,
-            ``,
-            `// 'backend' refuses to bucket rollout flags without an identity;`,
-            `// use 'frontend' in a browser runtime.`,
-            `export const bridge = new BridgeFlags({ mode: 'backend' });`,
-            ``,
-            `// Load the rule set for your app, for local evaluation (the framework SDKs do this`,
-            `// for you). To have Bridge evaluate for a signed-in user instead, see the`,
-            `// bulkEvaluate endpoint in \`bridge guide custom\`.`,
-            `const res = await fetch(`,
-            `  '${ctx.baseUrl}/admin/flags-internal/flags-cache/${ctx.appId}',`,
-            `);`,
-            `bridge.hydrate(await res.json());`,
-            ``,
-            `bridge.setContext({ identity: 'user-id', attributes: { /* plan, role, ... */ } });`,
-            ``,
-            `// Read a flag — T is inferred from defaultValue (boolean | string | number | json).`,
-            `// Returns FlagEvalResult<T> = { value, passed }, NOT a bare value.`,
-            `const { value: newDashboard } = bridge.flag('new-dashboard', false);`,
-            '```',
-        ].join('\n');
-    }
-    const pkg = pkgFor[framework];
-    // Per-framework idiomatic snippet.
-    switch (framework) {
-        case 'svelte':
-            return [
-                '# Bridge Flags — SvelteKit (flags-only)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-svelte',
-                '   ```',
-                '',
-                '2. Configure + mount the runtime once — `src/routes/+layout.svelte`:',
-                '   ```svelte',
-                '   <script lang="ts">',
-                `     import { BridgeProvider, bridgeConfig } from '@nebulr-group/bridge-svelte';`,
-                '',
-                '     bridgeConfig.initConfig({',
-                `       appId: '${ctx.appId}',`,
-                `       apiBaseUrl: '${ctx.baseUrl}',`,
-                '     });',
-                '',
-                '     let { children } = $props();',
-                '   </script>',
-                '',
-                '   <BridgeProvider>{@render children()}</BridgeProvider>',
-                '   ```',
-                '',
-                '3. Read a flag in any component under the provider:',
-                '   ```svelte',
-                '   <script lang="ts">',
-                `     import { useFlag } from '${pkg}';`,
-                '',
-                '     // Sync rune. Returns { value, passed } — NOT a bare value.',
-                '     // T is inferred from the default: boolean | string | number | json.',
-                `     const newDashboard = useFlag('new-dashboard', false);`,
-                '   </script>',
-                '',
-                '   {#if newDashboard.value}<V2 />{:else}<V1 />{/if}',
-                '   ```',
-                '',
-                '   Or declaratively:',
-                '   ```svelte',
-                `   import { FeatureFlag } from '${pkg}';`,
-                '   <FeatureFlag flag="new-dashboard">…</FeatureFlag>',
-                '   ```',
-            ].join('\n');
-        case 'react':
-            return [
-                '# Bridge Flags — React (flags-only)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-react',
-                '   ```',
-                '',
-                '2. In `src/main.tsx` — flags ride on the core Bridge runtime, so mount',
-                '   `<BridgeProvider>` (there is no separate flags provider):',
-                '   ```tsx',
-                `   import { BridgeProvider } from '@nebulr-group/bridge-react';`,
-                '',
-                `   <BridgeProvider config={{ appId: '${ctx.appId}', apiBaseUrl: '${ctx.baseUrl}' }}>`,
-                '     <App />',
-                '   </BridgeProvider>',
-                '   ```',
-                '   (`VITE_BRIDGE_APP_ID` / `VITE_BRIDGE_API_BASE_URL` override the props.)',
-                '',
-                '3. Use the hook in any component:',
-                '   ```tsx',
-                `   import { useFlag } from '${pkg}';`,
-                '',
-                '   function NewDashboard() {',
-                '     // Sync. Returns { value, passed } — destructure `value`.',
-                `     const { value: enabled } = useFlag('new-dashboard', false);`,
-                '     return enabled ? <V2 /> : <V1 />;',
-                '   }',
-                '   ```',
-            ].join('\n');
-        case 'nextjs':
-            return [
-                '# Bridge Flags — Next.js (flags-only)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-nextjs',
-                '   ```',
-                '',
-                '2. Client side — `app/providers.tsx`. FF 2.0 is folded into the',
-                '   `./client` entry point; there is no `/flags` subpath and no separate',
-                '   flags provider:',
-                '   ```tsx',
-                `   "use client";`,
-                `   import { BridgeProvider } from '${pkg}';`,
-                '',
-                '   export function Providers({ children }: { children: React.ReactNode }) {',
-                '     return (',
-                `       <BridgeProvider config={{ appId: '${ctx.appId}', apiBaseUrl: '${ctx.baseUrl}' }}>`,
-                '         {children}',
-                '       </BridgeProvider>',
-                '     );',
-                '   }',
-                '   ```',
-                '',
-                '   Then in any client component:',
-                '   ```tsx',
-                `   import { useFlag } from '${pkg}';`,
-                `   const { value: enabled } = useFlag('new-dashboard', false);`,
-                '   ```',
-                '',
-                '3. Server side — Server Component / Route Handler / middleware. The',
-                '   server flag surface is a singleton, and every read is async and takes',
-                '   the `NextRequest` (that is where identity comes from):',
-                '   ```ts',
-                `   import { FeatureFlagServer } from '@nebulr-group/bridge-nextjs/server';`,
-                '',
-                '   // Once at boot:',
-                '   FeatureFlagServer.getInstance().init({',
-                `     appId: '${ctx.appId}',`,
-                `     apiBaseUrl: '${ctx.baseUrl}',`,
-                '   });',
-                '',
-                '   // Per request — evaluated locally in-process, no round trip per flag:',
-                `   const enabled = await FeatureFlagServer.getInstance().flagServer('new-dashboard', false, request);`,
-                '   ```',
-            ].join('\n');
-        case 'angular':
-            return [
-                '# Bridge Flags — Angular (flags-only)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-angular',
-                '   ```',
-                '',
-                '2. In `app.config.ts` — one provider covers auth + flags (the package',
-                '   ships a single entry point, so import from the bare specifier):',
-                '   ```ts',
-                `   import { provideBridge } from '${pkg}';`,
-                '',
-                '   export const appConfig: ApplicationConfig = {',
-                '     providers: [',
-                '       provideBridge({',
-                `         appId: '${ctx.appId}',`,
-                `         apiBaseUrl: '${ctx.baseUrl}',`,
-                '       }),',
-                '     ],',
-                '   };',
-                '   ```',
-                '',
-                '3. Inject `BridgeService` — `flag()` returns a Signal of { value, passed }:',
-                '   ```ts',
-                `   import { BridgeService } from '${pkg}';`,
-                '',
-                '   private bridge = inject(BridgeService);',
-                '',
-                `   newDashboard = this.bridge.flag('new-dashboard', false);`,
-                '   // template: {{ newDashboard().value }}',
-                '',
-                '   // One-shot, non-reactive read:',
-                `   // const { value } = this.bridge.evaluate('new-dashboard', false);`,
-                '   ```',
-            ].join('\n');
-        case 'nestjs':
-            return [
-                '# Bridge Flags — NestJS (flags-only, backend mode)',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-nestjs',
-                '   ```',
-                '',
-                '2. Import the module in `app.module.ts` (requires bridge-nestjs >= 0.6.0):',
-                '   ```ts',
-                `   import { BridgeFlagsModule } from '${pkg}';`,
-                '',
-                '   @Module({',
-                '     imports: [',
-                '       BridgeFlagsModule.forRoot({',
-                `         apiBaseUrl: '${ctx.baseUrl}',`,
-                `         appId: '${ctx.appId}',`,
-                `         apiKey: process.env.BRIDGE_API_KEY!, // a Bridge API token, never the app id`,
-                `         mode: 'backend',`,
-                '       }),',
-                '     ],',
-                '   })',
-                '   export class AppModule {}',
-                '   ```',
-                '',
-                '3. Inject in any service / controller:',
-                '   ```ts',
-                `   import { BridgeFlagsService } from '${pkg}';`,
-                '',
-                '   constructor(private flags: BridgeFlagsService) {}',
-                '',
-                '   handleRequest(req) {',
-                '     // Sync, evaluated locally in-process. Returns T directly.',
-                `     const enabled = this.flags.flag('new-checkout', false, {`,
-                '       identity: req.bridgeUser?.id,',
-                '       attributes: { plan: req.bridgeUser?.plan },',
-                '     });',
-                '   }',
-                '   ```',
-            ].join('\n');
-        case 'express':
-            return [
-                '# Bridge Flags — Express',
-                '',
-                '   NOTE: express does not have a standalone flags runtime. Flags are',
-                '   part of the auth middleware, are boolean-only, require a user JWT,',
-                '   and are evaluated remotely by the Bridge API (see TBP-516).',
-                '',
-                `1. Install:`,
-                '   ```bash',
-                '   bun add @nebulr-group/bridge-express',
-                '   ```',
-                '',
-                '2. At app bootstrap:',
-                '   ```ts',
-                `   import { createBridge } from '${pkg}';`,
-                '',
-                '   const bridge = createBridge({',
-                `     appId: '${ctx.appId}',`,
-                `     apiBaseUrl: '${ctx.baseUrl}',`,
-                '     guard: { defaultAccess: \'protected\' },',
-                '   });',
-                '',
-                '   app.use(bridge.auth());',
-                '   ```',
-                '',
-                '3. Gate a route on a flag — `featureFlag` accepts',
-                '   `string | { any: string[] } | { all: string[] }`; a miss is a 403:',
-                '   ```ts',
-                `   app.get('/beta', bridge.protect({ featureFlag: 'new-home' }), (req, res) => {`,
-                `     res.send('v2');`,
-                '   });',
-                '',
-                '   // Or centrally, via guard.rules:',
-                `   // { path: '/beta/**', privilege: 'AUTHENTICATED', featureFlag: { any: ['new-home', 'beta'] } }`,
-                '   ```',
-                '',
-                '4. Read a flag inside a handler:',
-                '   ```ts',
-                `   import { BridgeConfigService, FeatureFlagService } from '${pkg}';`,
-                '',
-                '   const flags = new FeatureFlagService(',
-                `     new BridgeConfigService({ appId: '${ctx.appId}', apiBaseUrl: '${ctx.baseUrl}' }),`,
-                '   );',
-                '',
-                `   app.get('/', bridge.protect(), async (req, res) => {`,
-                '     // Boolean only. Async — remote evaluation, cached 5 min per token.',
-                `     const enabled = await flags.isEnabled('new-home', req.bridgeAccessToken!);`,
-                `     res.send(enabled ? 'v2' : 'v1');`,
-                '   });',
-                '   ```',
-            ].join('\n');
-    }
-}
-// ── Provider config + next-steps blurbs ─────────────────────────────────────
-function suggestedProviderConfig(framework) {
-    // Keys mirror the real option names on the framework's flags runtime
-    // (`createBridgeFlags` / `BridgeFlagsModule.forRoot`) — `mode` is
-    // `'frontend' | 'backend'`, `telemetry` is a partial TelemetryBatcherConfig.
-    if (framework === 'express') {
-        // express has no BridgeFlags runtime — nothing to configure. Flags are
-        // enforced through `bridge.protect({ featureFlag })` and evaluated remotely
-        // by the Bridge API. See TBP-516.
-        return {
-            runtime: 'none',
-            note: 'bridge-express evaluates flags remotely inside the auth middleware; there is no local flags provider to configure.',
-        };
-    }
-    if (framework === 'nestjs') {
-        return { mode: 'backend', telemetry: { enabled: true, flushIntervalMs: 5000 } };
-    }
-    return { mode: 'frontend', telemetry: { enabled: true, flushIntervalMs: 5000 } };
-}
-function nextStepsFor(framework) {
-    const base = [
-        'Apply the printed snippet to the file noted above.',
-        'Run `bridge guide flags' + (framework !== 'unknown' ? ` --framework ${framework}` : '') + '` for the full integration prompt.',
-        'Create your first flag: `bridge flag create --key hello-flag --state on --value-type boolean --on-value true --off-value false`',
-        'Eval it locally: `bridge flag eval hello-flag --identity demo-user`',
-    ];
-    if (framework === 'unknown') {
-        return [
-            'Could not auto-detect your framework — pass --framework <name> to scope the snippet.',
-            ...base,
-        ];
-    }
-    return base;
-}
-/** Probe whether a path exists (used by tests). */
-export async function pathExists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=flag-init.command.js.map

package/dist/commands/flag-init.command.js.map

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

package/dist/commands/guide.command.d.ts

@@ -1,61 +0,0 @@
-import { Command } from 'commander';
-export type GuideCoverage = {
-    aliases: Record<string, string>;
-    frameworks: Record<string, string[]>;
-    /** Framework-agnostic guides bundled with the CLI: topic -> what it covers. */
-    topics: Record<string, string>;
-};
-/**
- * Which per-framework guides exist, from `prompts/guide-coverage.json`.
- *
- * That file is the one copy (TBP-706): this command lists it, and the Bridge
- * MCP server reads the same file from GitHub for its "no such guide" answers.
- * Before it, the CLI, the MCP server and the auth master prompt gave three
- * different answers, and the CLI's was the most out of date.
- */
-export declare function loadGuideCoverage(): GuideCoverage;
-declare const FLAGS_FRAMEWORKS: readonly ["svelte", "react", "nextjs", "angular", "nestjs", "express"];
-type FlagsFramework = (typeof FLAGS_FRAMEWORKS)[number];
-declare const BILLING_FRAMEWORKS: readonly ["svelte", "react", "nextjs", "angular", "nestjs", "express"];
-type BillingFramework = (typeof BILLING_FRAMEWORKS)[number];
-export declare function registerGuideCommands(program: Command): void;
-/**
- * TBP-540 (folds TBP-599) — `bridge guide <framework>` prints the HOSTED
- * sign-in guide, and used to say nothing about the other mode. A developer who
- * wanted in-app forms never learned `bridge guide svelte sdk-auth` existed,
- * hand-wrote a login form against `/auth/login` (a 404) and shipped it. So a
- * framework that has an SDK-auth guide opens by naming both modes; one that
- * has none (the backends) is unchanged.
- *
- * TBP-807 — the per-framework guide now sets up in-app (SDK) sign-in itself,
- * so there is no mode to pick; the preface only points at the guide for the
- * sign-in pages and their design.
- */
-export declare function authModesPreface(tech: string, coverage: Record<string, string[]>): string | null;
-export declare const MECHANISMS_PROMPT_FILENAME = "mechanisms.md";
-export declare const ORIENTATION_PROMPT_FILENAME = "orientation.md";
-export declare const FIT_TOGETHER_PROMPT_FILENAME = "fit-together.md";
-/** The mechanisms page, bundled with the CLI (`BRIDGE_GUIDE_LOCAL_DIR` wins in development). */
-export declare function fetchMechanismsGuide(): Promise<string>;
-/** The orientation map, bundled with the CLI (`BRIDGE_GUIDE_LOCAL_DIR` wins in development). */
-export declare function fetchOrientationGuide(): Promise<string>;
-/** How roles, plans, limits and flags fit together, bundled with the CLI (`BRIDGE_GUIDE_LOCAL_DIR` wins in development). */
-export declare function fetchFitTogetherGuide(): Promise<string>;
-/**
- * Detect framework from package.json so `bridge guide flags` can be called
- * bare. Same heuristic order as `bridge flag init`.
- */
-export declare function resolveFlagsFramework(override: string | undefined, cwd: string): Promise<FlagsFramework | undefined>;
-/**
- * Bridge-cli only bundles the generic master orchestrators. Per-framework
- * prompts always come from the plugin repos' mcp/ folder via `fetchGuide`.
- */
-export declare function fetchFlagsMasterPrompt(): Promise<string>;
-export declare function fetchBillingMasterPrompt(): Promise<string>;
-/**
- * Detect framework for Billing 2.0. Mirrors resolveFlagsFramework — same
- * package.json heuristic order, validated against BILLING_FRAMEWORKS.
- */
-export declare function resolveBillingFramework(override: string | undefined, cwd: string): Promise<BillingFramework | undefined>;
-export {};
-//# sourceMappingURL=guide.command.d.ts.map

package/dist/commands/guide.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"guide.command.d.ts","sourceRoot":"","sources":["../../src/commands/guide.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCpC,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAejD;AAED,QAAA,MAAM,gBAAgB,wEAAyE,CAAC;AAChG,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,QAAA,MAAM,kBAAkB,wEAAyE,CAAC;AAClG,KAAK,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAyB5D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6O5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAOhG;AAWD,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAC5D,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAE9D,gGAAgG;AAChG,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5D;AAED,gGAAgG;AAChG,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7D;AAED,4HAA4H;AAC5H,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7D;AA0CD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA0BrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9D;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhE;AAqCD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA0BvC"}