create-hq 7.0.0 → 10.1.0

package/dist/__tests__/deps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deps.test.d.ts.map

package/dist/__tests__/deps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/deps.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/deps.test.js

@@ -0,0 +1,176 @@
+import { describe, it, expect } from "vitest";
+import { getInstallCommand } from "../deps.js";
+// ─── Test Fixtures ──────────────────────────────────────────────────────────
+function makeDep(overrides = {}) {
+    return {
+        name: "test-dep",
+        command: "test --version",
+        required: true,
+        installHint: "brew install test",
+        autoInstallable: true,
+        installCommands: {},
+        ...overrides,
+    };
+}
+function makePlatform(overrides = {}) {
+    return {
+        os: "macos",
+        packageManager: "brew",
+        npmAvailable: true,
+        ...overrides,
+    };
+}
+const yqDep = makeDep({
+    name: "yq",
+    command: "yq --version",
+    installHint: "brew install yq",
+    installCommands: {
+        brew: "brew install yq",
+        apt: "sudo snap install yq",
+        dnf: "sudo dnf install yq",
+        pacman: "sudo pacman -S yq",
+    },
+});
+const ghDep = makeDep({
+    name: "gh CLI",
+    command: "gh --version",
+    required: false,
+    installHint: "brew install gh",
+    installCommands: {
+        brew: "brew install gh",
+        apt: "sudo apt install gh",
+        dnf: "sudo dnf install gh",
+        pacman: "sudo pacman -S github-cli",
+    },
+});
+const claudeCodeDep = makeDep({
+    name: "Claude Code CLI",
+    command: "claude --version",
+    installHint: "npm install -g @anthropic-ai/claude-code",
+    installCommands: {
+        npm: "npm install -g @anthropic-ai/claude-code",
+    },
+});
+const qmdDep = makeDep({
+    name: "qmd (search)",
+    command: "qmd --version",
+    installHint: "npm install -g @tobilu/qmd",
+    installCommands: {
+        npm: "npm install -g @tobilu/qmd",
+    },
+});
+const vercelDep = makeDep({
+    name: "Vercel CLI",
+    command: "vercel --version",
+    required: false,
+    installHint: "npm install -g vercel",
+    installCommands: {
+        npm: "npm install -g vercel",
+    },
+});
+const hqCliDep = makeDep({
+    name: "hq-cli",
+    command: "hq --version",
+    required: false,
+    installHint: "npm install -g @indigoai-us/hq-cli",
+    installCommands: {
+        npm: "npm install -g @indigoai-us/hq-cli",
+    },
+});
+const nodeDep = makeDep({
+    name: "Node.js",
+    command: "node --version",
+    required: true,
+    installHint: "https://nodejs.org",
+    autoInstallable: false,
+    installCommands: {},
+});
+// ─── Platforms ──────────────────────────────────────────────────────────────
+const macBrew = makePlatform({ os: "macos", packageManager: "brew", npmAvailable: true });
+const linuxApt = makePlatform({ os: "linux-debian", packageManager: "apt", npmAvailable: true });
+const linuxDnf = makePlatform({ os: "linux-fedora", packageManager: "dnf", npmAvailable: true });
+const linuxPacman = makePlatform({ os: "linux-arch", packageManager: "pacman", npmAvailable: true });
+const linuxYum = makePlatform({ os: "linux-fedora", packageManager: "yum", npmAvailable: true });
+const noPmNoNpm = makePlatform({ os: "unix", packageManager: null, npmAvailable: false });
+const noPmWithNpm = makePlatform({ os: "unix", packageManager: null, npmAvailable: true });
+// ─── Tests ──────────────────────────────────────────────────────────────────
+describe("getInstallCommand", () => {
+    describe("macOS + brew", () => {
+        it("returns brew command for yq", () => {
+            expect(getInstallCommand(yqDep, macBrew)).toBe("brew install yq");
+        });
+        it("returns brew command for gh CLI", () => {
+            expect(getInstallCommand(ghDep, macBrew)).toBe("brew install gh");
+        });
+        it("returns npm command for npm-only deps (prefers system PM, falls back to npm)", () => {
+            // Claude Code only has npm install command, no brew
+            expect(getInstallCommand(claudeCodeDep, macBrew)).toBe("npm install -g @anthropic-ai/claude-code");
+        });
+    });
+    describe("Linux + apt", () => {
+        it("returns apt command for yq", () => {
+            expect(getInstallCommand(yqDep, linuxApt)).toBe("sudo snap install yq");
+        });
+        it("returns apt command for gh CLI", () => {
+            expect(getInstallCommand(ghDep, linuxApt)).toBe("sudo apt install gh");
+        });
+    });
+    describe("Linux + dnf", () => {
+        it("returns dnf command for yq", () => {
+            expect(getInstallCommand(yqDep, linuxDnf)).toBe("sudo dnf install yq");
+        });
+    });
+    describe("Linux + pacman", () => {
+        it("returns pacman command for gh CLI", () => {
+            expect(getInstallCommand(ghDep, linuxPacman)).toBe("sudo pacman -S github-cli");
+        });
+    });
+    describe("yum → dnf fallback", () => {
+        it("maps yum to dnf commands", () => {
+            expect(getInstallCommand(yqDep, linuxYum)).toBe("sudo dnf install yq");
+        });
+    });
+    describe("npm-only deps", () => {
+        it("returns npm command for Claude Code when npm available", () => {
+            expect(getInstallCommand(claudeCodeDep, noPmWithNpm)).toBe("npm install -g @anthropic-ai/claude-code");
+        });
+        it("returns npm command for qmd when npm available", () => {
+            expect(getInstallCommand(qmdDep, noPmWithNpm)).toBe("npm install -g @tobilu/qmd");
+        });
+        it("returns npm command for Vercel CLI when npm available", () => {
+            expect(getInstallCommand(vercelDep, noPmWithNpm)).toBe("npm install -g vercel");
+        });
+        it("returns npm command for hq-cli when npm available", () => {
+            expect(getInstallCommand(hqCliDep, noPmWithNpm)).toBe("npm install -g @indigoai-us/hq-cli");
+        });
+        it("returns null for npm-only deps when npm not available", () => {
+            expect(getInstallCommand(claudeCodeDep, noPmNoNpm)).toBeNull();
+        });
+    });
+    describe("Node.js dep (no install path)", () => {
+        it("returns null — empty installCommands", () => {
+            expect(getInstallCommand(nodeDep, macBrew)).toBeNull();
+        });
+        it("returns null even with npm available", () => {
+            expect(getInstallCommand(nodeDep, noPmWithNpm)).toBeNull();
+        });
+        it("has autoInstallable set to false", () => {
+            expect(nodeDep.autoInstallable).toBe(false);
+        });
+    });
+    describe("no matching package manager and no npm", () => {
+        it("returns null for system deps when no PM and no npm", () => {
+            expect(getInstallCommand(yqDep, noPmNoNpm)).toBeNull();
+        });
+        it("returns null for gh CLI when no PM and no npm", () => {
+            expect(getInstallCommand(ghDep, noPmNoNpm)).toBeNull();
+        });
+    });
+    describe("npm fallback for system deps", () => {
+        it("falls back to npm when no system PM but npm available (for deps with npm command)", () => {
+            // yq has no npm command, so should return null
+            expect(getInstallCommand(yqDep, noPmWithNpm)).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=deps.test.js.map

package/dist/__tests__/deps.test.js.map

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

package/dist/__tests__/platform.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform.test.d.ts.map

package/dist/__tests__/platform.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/platform.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/platform.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+// We need to mock child_process before importing the module
+const mockExecSync = vi.fn();
+vi.mock("child_process", () => ({
+    execSync: (...args) => mockExecSync(...args),
+}));
+// Dynamic import so mocks are in place
+const { detectPlatform } = await import("../platform.js");
+describe("detectPlatform", () => {
+    const validOsTypes = [
+        "macos",
+        "linux-debian",
+        "linux-fedora",
+        "linux-arch",
+        "linux",
+        "unix",
+    ];
+    const validPackageManagers = [
+        "brew",
+        "apt",
+        "dnf",
+        "yum",
+        "pacman",
+        null,
+    ];
+    beforeEach(() => {
+        mockExecSync.mockReset();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns a PlatformInfo object with valid os field matching process.platform", () => {
+        // Let hasBin calls succeed for common tools
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "which brew")
+                return Buffer.from("/opt/homebrew/bin/brew");
+            if (cmd === "which npm")
+                return Buffer.from("/usr/local/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result).toHaveProperty("os");
+        expect(result).toHaveProperty("packageManager");
+        expect(result).toHaveProperty("npmAvailable");
+        expect(validOsTypes).toContain(result.os);
+        // On macOS CI/local, process.platform is "darwin" → os should be "macos"
+        if (process.platform === "darwin") {
+            expect(result.os).toBe("macos");
+        }
+        else if (process.platform === "linux") {
+            expect(result.os).toMatch(/^linux/);
+        }
+    });
+    it("npmAvailable is a boolean", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "which npm")
+                return Buffer.from("/usr/local/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(typeof result.npmAvailable).toBe("boolean");
+    });
+    it("packageManager is a valid value or null", () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(validPackageManagers).toContain(result.packageManager);
+    });
+    it("detects brew on macOS when brew is available", () => {
+        // Mock process.platform to darwin
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "darwin", writable: true });
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "which brew")
+                return Buffer.from("/opt/homebrew/bin/brew");
+            if (cmd === "which npm")
+                return Buffer.from("/usr/local/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("macos");
+        expect(result.packageManager).toBe("brew");
+        expect(result.npmAvailable).toBe(true);
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+    it("returns null packageManager on macOS when brew is not available", () => {
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "darwin", writable: true });
+        mockExecSync.mockImplementation(() => {
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("macos");
+        expect(result.packageManager).toBeNull();
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+    it("detects apt on linux-debian", () => {
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "linux", writable: true });
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "cat /etc/os-release") {
+                return Buffer.from('ID=ubuntu\nID_LIKE=debian\nVERSION_ID="22.04"');
+            }
+            if (cmd === "which apt")
+                return Buffer.from("/usr/bin/apt");
+            if (cmd === "which npm")
+                return Buffer.from("/usr/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("linux-debian");
+        expect(result.packageManager).toBe("apt");
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+    it("returns 'unix' for non-darwin non-linux platforms", () => {
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "freebsd", writable: true });
+        mockExecSync.mockImplementation(() => {
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("unix");
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+});
+//# sourceMappingURL=platform.test.js.map

package/dist/__tests__/platform.test.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Auth utilities for create-hq — OAuth PKCE flow for Clerk (US-008)
+ *
+ * Reuses the same patterns as hq-cli/src/utils/auth.ts and
+ * hq-cli/src/utils/token-store.ts but bundled inline so create-hq
+ * has no dependency on @indigoai-us/hq-cli.
+ *
+ * Token values are NEVER written to stdout or logs.
+ */
+export interface AuthToken {
+    clerk_session_token: string;
+    user_id: string;
+    email: string;
+    expires_at: string;
+}
+/** Save auth token to ~/.hq/auth.json with 0600 permissions. */
+export declare function saveToken(token: AuthToken): void;
+/** Load auth token from ~/.hq/auth.json. Returns null if missing/invalid. */
+export declare function loadToken(): AuthToken | null;
+/** Check if a token is expired or within 5 minutes of expiry. */
+export declare function isTokenExpired(token: AuthToken): boolean;
+/**
+ * Start the OAuth PKCE auth flow:
+ * 1. Generate PKCE code_verifier + code_challenge
+ * 2. Start local HTTP server on a random port for the callback
+ * 3. Open browser to Clerk auth URL
+ * 4. Wait for callback with auth code
+ * 5. Exchange code for token via registry /auth/token endpoint
+ * 6. Save token and return AuthToken
+ */
+export declare function startAuthFlow(registryUrl: string): Promise<AuthToken>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,WAAW,SAAS;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAIhD;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,IAAI,SAAS,GAAG,IAAI,CAqB5C;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAIxD;AA0BD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAkG3E"}

package/dist/auth.js

@@ -0,0 +1,156 @@
+/**
+ * Auth utilities for create-hq — OAuth PKCE flow for Clerk (US-008)
+ *
+ * Reuses the same patterns as hq-cli/src/utils/auth.ts and
+ * hq-cli/src/utils/token-store.ts but bundled inline so create-hq
+ * has no dependency on @indigoai-us/hq-cli.
+ *
+ * Token values are NEVER written to stdout or logs.
+ */
+import * as crypto from "crypto";
+import * as http from "http";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { exec } from "child_process";
+const HQ_DIR = path.join(os.homedir(), ".hq");
+const AUTH_FILE = path.join(HQ_DIR, "auth.json");
+// ─── Token store ─────────────────────────────────────────────────────────────
+function ensureHqDir() {
+    if (!fs.existsSync(HQ_DIR)) {
+        fs.mkdirSync(HQ_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/** Save auth token to ~/.hq/auth.json with 0600 permissions. */
+export function saveToken(token) {
+    ensureHqDir();
+    const content = JSON.stringify(token, null, 2);
+    fs.writeFileSync(AUTH_FILE, content, { mode: 0o600 });
+}
+/** Load auth token from ~/.hq/auth.json. Returns null if missing/invalid. */
+export function loadToken() {
+    try {
+        if (!fs.existsSync(AUTH_FILE)) {
+            return null;
+        }
+        const content = fs.readFileSync(AUTH_FILE, "utf-8");
+        const parsed = JSON.parse(content);
+        if (typeof parsed.clerk_session_token !== "string" ||
+            typeof parsed.user_id !== "string" ||
+            typeof parsed.email !== "string" ||
+            typeof parsed.expires_at !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** Check if a token is expired or within 5 minutes of expiry. */
+export function isTokenExpired(token) {
+    const expiresAt = new Date(token.expires_at).getTime();
+    const bufferMs = 5 * 60 * 1000;
+    return Date.now() >= expiresAt - bufferMs;
+}
+// ─── PKCE helpers ────────────────────────────────────────────────────────────
+function generateCodeVerifier() {
+    return crypto.randomBytes(32).toString("base64url");
+}
+function generateCodeChallenge(verifier) {
+    return crypto.createHash("sha256").update(verifier).digest("base64url");
+}
+function openBrowser(url) {
+    const command = process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
+    exec(command, (err) => {
+        if (err) {
+            console.error(`Could not open browser automatically. Please visit:\n  ${url}`);
+        }
+    });
+}
+// ─── Auth flow ───────────────────────────────────────────────────────────────
+/**
+ * Start the OAuth PKCE auth flow:
+ * 1. Generate PKCE code_verifier + code_challenge
+ * 2. Start local HTTP server on a random port for the callback
+ * 3. Open browser to Clerk auth URL
+ * 4. Wait for callback with auth code
+ * 5. Exchange code for token via registry /auth/token endpoint
+ * 6. Save token and return AuthToken
+ */
+export async function startAuthFlow(registryUrl) {
+    const codeVerifier = generateCodeVerifier();
+    const codeChallenge = generateCodeChallenge(codeVerifier);
+    return new Promise((resolve, reject) => {
+        const server = http.createServer(async (req, res) => {
+            try {
+                const url = new URL(req.url ?? "/", "http://localhost");
+                if (url.pathname !== "/callback") {
+                    res.writeHead(404);
+                    res.end("Not found");
+                    return;
+                }
+                const code = url.searchParams.get("code");
+                const error = url.searchParams.get("error");
+                if (error) {
+                    res.writeHead(200, { "Content-Type": "text/html" });
+                    res.end("<html><body><h2>Authentication failed</h2><p>You can close this window.</p></body></html>");
+                    server.close();
+                    reject(new Error(`Auth failed: ${error}`));
+                    return;
+                }
+                if (!code) {
+                    res.writeHead(400, { "Content-Type": "text/html" });
+                    res.end("<html><body><h2>Missing auth code</h2><p>You can close this window.</p></body></html>");
+                    server.close();
+                    reject(new Error("No authorization code received"));
+                    return;
+                }
+                // Exchange code for token
+                const tokenResponse = await fetch(`${registryUrl}/auth/token`, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        code,
+                        code_verifier: codeVerifier,
+                        redirect_uri: `http://localhost:${server.address().port}/callback`,
+                    }),
+                });
+                if (!tokenResponse.ok) {
+                    const body = await tokenResponse.text();
+                    res.writeHead(200, { "Content-Type": "text/html" });
+                    res.end("<html><body><h2>Token exchange failed</h2><p>You can close this window.</p></body></html>");
+                    server.close();
+                    reject(new Error(`Token exchange failed (${tokenResponse.status}): ${body}`));
+                    return;
+                }
+                const tokenData = (await tokenResponse.json());
+                // Save token to ~/.hq/auth.json
+                saveToken(tokenData);
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end("<html><body><h2>Authenticated!</h2><p>You can close this window and return to the terminal.</p></body></html>");
+                server.close();
+                resolve(tokenData);
+            }
+            catch (err) {
+                server.close();
+                reject(err);
+            }
+        });
+        // Listen on random port
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const redirectUri = `http://localhost:${addr.port}/callback`;
+            const authUrl = `${registryUrl}/auth/login?redirect_uri=${encodeURIComponent(redirectUri)}&code_challenge=${codeChallenge}&code_challenge_method=S256`;
+            console.log("  Opening browser for authentication...");
+            openBrowser(authUrl);
+            console.log(`\n  If the browser doesn't open, visit:\n  ${authUrl}\n`);
+        });
+        // Timeout after 2 minutes
+        setTimeout(() => {
+            server.close();
+            reject(new Error("Authentication timed out after 2 minutes"));
+        }, 120_000);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/deps.d.ts

@@ -1,4 +1,34 @@
-export declare function checkDeps(): {
+import type { PlatformInfo } from "./platform.js";
+export type DepStatus = "installed" | "just-installed" | "missing" | "skipped";
+export interface DepResult {
+    name: string;
+    required: boolean;
+    status: DepStatus;
+    version?: string;
+    installHint: string;
+}
+export interface InstallCommands {
+    brew?: string;
+    apt?: string;
+    dnf?: string;
+    pacman?: string;
+    npm?: string;
+}
+export interface Dep {
+    name: string;
+    command: string;
+    required: boolean;
+    installHint: string;
+    autoInstallable: boolean;
+    installCommands: InstallCommands;
+}
+/**
+ * Pick the best install command for a dep given the detected platform.
+ * Prefers the system package manager, falls back to npm if available.
+ * Returns null when no suitable command exists (e.g. Node.js — manual install).
+ */
+export declare function getInstallCommand(dep: Dep, platform: PlatformInfo): string | null;
+export declare function checkDeps(): Promise<{
     allRequired: boolean;
-};
+}>;
 //# sourceMappingURL=deps.d.ts.map

package/dist/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AA2DA,wBAAgB,SAAS,IAAI;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAoBpD"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;CAClC;AA+ED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,YAAY,GACrB,MAAM,GAAG,IAAI,CAef;AAoCD,wBAAsB,SAAS,IAAI,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CA+EnE"}