@sun-asterisk/sungen 3.2.2-beta.9 → 3.2.3-beta.3

package/dist/orchestrator/mobile-runtime-scaffolder.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Mobile Runtime Scaffolder
+ *
+ * Emits the Appium/WebdriverIO harness files into a project directory.
+ * Called by ProjectInitializer (init --mobile) and, in Phase 02, by `capability add mobile`.
+ * Never duplicated — always imported from here.
+ */
+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.emitMobileRuntime = emitMobileRuntime;
+exports.writeMobileCapabilities = writeMobileCapabilities;
+exports.installMobileDriver = installMobileDriver;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const capability_1 = require("../harness/capability");
+/** Read a template from the orchestrator's bundled templates directory. */
+function readTemplate(filename) {
+    const templatePath = path.join(__dirname, 'templates', filename);
+    return fs.readFileSync(templatePath, 'utf-8');
+}
+/**
+ * Emit the mobile runtime harness into `cwd`.
+ *
+ * Files written:
+ *   wdio.conf.ts                        — project root (seeded from mobile options)
+ *   specs/reporters/pw-shape-reporter.ts — Playwright-shaped JSON reporter for WDIO
+ *   .env.appium                          — seeded from flags (gitignored)
+ *   .env.appium.example                 — committed placeholder guide
+ *
+ * The caller is responsible for adding `test:mobile` to package.json scripts and
+ * writing qa/capabilities.yaml — helpers for both are exported below.
+ */
+function emitMobileRuntime(cwd, opts) {
+    const created = [];
+    const skipped = [];
+    // wdio.conf.ts (project root) — substitute init-provided app defaults into the template
+    const wdioPath = path.join(cwd, 'wdio.conf.ts');
+    if (fs.existsSync(wdioPath)) {
+        skipped.push('wdio.conf.ts');
+    }
+    else {
+        const content = readTemplate('wdio.conf.ts')
+            .replace('__APP_PACKAGE__', opts.appPackage || 'com.example.app')
+            // appActivity is optional — leave empty when not provided so UiAutomator2
+            // auto-resolves the launcher activity from appPackage. Only pin when explicitly passed.
+            .replace('__APP_ACTIVITY__', opts.appActivity || '')
+            .replace('__ANDROID_UDID__', opts.androidUdid || 'emulator-5554')
+            .replace('__IOS_BUNDLE_ID__', opts.iosBundleId || 'com.example.app')
+            .replace('__IOS_DEVICE__', opts.iosDevice || 'iPhone 16')
+            .replace('__IOS_VERSION__', opts.iosVersion || '18.0');
+        fs.writeFileSync(wdioPath, content, 'utf-8');
+        created.push('wdio.conf.ts');
+    }
+    // specs/reporters/pw-shape-reporter.ts
+    const reporterPath = path.join(cwd, 'specs', 'reporters', 'pw-shape-reporter.ts');
+    if (fs.existsSync(reporterPath)) {
+        skipped.push('specs/reporters/pw-shape-reporter.ts');
+    }
+    else {
+        fs.mkdirSync(path.dirname(reporterPath), { recursive: true });
+        fs.writeFileSync(reporterPath, readTemplate('specs-pw-shape-reporter.ts'), 'utf-8');
+        created.push('specs/reporters/pw-shape-reporter.ts');
+    }
+    // .env.appium — seeded from the flags that were provided; env vars that were not passed
+    // are left commented out so the file is a useful guide without imposing bogus values.
+    const envPath = path.join(cwd, '.env.appium');
+    if (fs.existsSync(envPath)) {
+        skipped.push('.env.appium');
+    }
+    else {
+        const lines = [
+            '# .env.appium — loaded by wdio.conf.ts. Shell exports override these values.',
+            '# See .env.appium.example for the full reference.',
+            '',
+        ];
+        if (opts.appPackage)
+            lines.push(`APP_PACKAGE=${opts.appPackage}`);
+        if (opts.appActivity)
+            lines.push(`APP_ACTIVITY=${opts.appActivity}`);
+        if (opts.appApk)
+            lines.push(`APP_APK=${opts.appApk}`);
+        if (opts.androidUdid)
+            lines.push(`ANDROID_UDID=${opts.androidUdid}`);
+        if (opts.iosBundleId)
+            lines.push(`IOS_BUNDLE_ID=${opts.iosBundleId}`);
+        if (opts.iosDevice)
+            lines.push(`IOS_DEVICE=${opts.iosDevice}`);
+        if (opts.iosVersion)
+            lines.push(`IOS_VERSION=${opts.iosVersion}`);
+        lines.push('');
+        fs.writeFileSync(envPath, lines.join('\n'), 'utf-8');
+        created.push('.env.appium');
+    }
+    // .env.appium.example — committed placeholder guide (template stored without leading dot
+    // so copy-templates' glob picks it up; the output file gets the dot).
+    const envExamplePath = path.join(cwd, '.env.appium.example');
+    if (fs.existsSync(envExamplePath)) {
+        skipped.push('.env.appium.example');
+    }
+    else {
+        fs.writeFileSync(envExamplePath, readTemplate('env.appium.example'), 'utf-8');
+        created.push('.env.appium.example');
+    }
+    return { created, skipped };
+}
+/**
+ * Write qa/capabilities.yaml for a mobile project.
+ * Uses the canonical writeCapabilities from harness/capability so the format is always consistent.
+ */
+function writeMobileCapabilities(cwd) {
+    return (0, capability_1.writeCapabilities)(cwd, { platform: 'mobile', enabled: ['mobile'] });
+}
+/**
+ * Resolve the install spec for `@sungen/driver-mobile`.
+ *
+ * In a monorepo checkout (dev / dogfood) the driver lives at `packages/driver-mobile` next to core and
+ * is NOT published to the registry — so we install it by `file:` path. In a published install (core in
+ * node_modules, no sibling package) we fall back to the registry pinned to the core version (lockstep).
+ *
+ * Why: a bare `@sungen/driver-mobile@<coreVersion>` hits npm E404 whenever the driver is unpublished or
+ * the consuming project lives outside the workspace (`test-mobile/`). The local `file:` path makes the
+ * dev/dogfood path work without the registry, while the registry fallback preserves lockstep for users.
+ */
+function resolveMobileDriverSpec() {
+    // From this file (src/orchestrator OR dist/orchestrator) the sibling driver package is ../../../driver-mobile.
+    const localDriverDir = path.resolve(__dirname, '..', '..', '..', 'driver-mobile');
+    if (fs.existsSync(path.join(localDriverDir, 'package.json'))) {
+        return `file:${localDriverDir}`;
+    }
+    let coreVersion = 'latest';
+    try {
+        coreVersion = require('../../package.json').version || 'latest';
+    }
+    catch {
+        // noop — fall back to latest
+    }
+    return `@sungen/driver-mobile@${coreVersion}`;
+}
+/** Best-effort `npm install -D <specs…> [extraArgs…]` in `cwd`. Returns true on exit code 0. */
+function npmInstallDev(cwd, specs, extraArgs = []) {
+    const result = (0, child_process_1.spawnSync)('npm', ['install', '-D', ...specs, ...extraArgs], { cwd, stdio: 'inherit', shell: true });
+    return result.status === 0;
+}
+/**
+ * Locate the project's locally-installed appium CLI bin. Walks up from `cwd` so it works whether the
+ * appium dep is nested under @sungen/driver-mobile or hoisted to a parent node_modules/.bin. Returns
+ * null when appium is not installed in the project (then we skip cleanly — no `npx` auto-fetch).
+ */
+function appiumBinPath(cwd) {
+    const binName = process.platform === 'win32' ? 'appium.cmd' : 'appium';
+    let dir = path.resolve(cwd);
+    for (let i = 0; i < 8; i++) {
+        const bin = path.join(dir, 'node_modules', '.bin', binName);
+        if (fs.existsSync(bin))
+            return bin;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/** Appium platform drivers already installed in ~/.appium (per-user). Empty set if it can't tell. */
+function installedAppiumDrivers(appiumBin, cwd) {
+    const r = (0, child_process_1.spawnSync)(appiumBin, ['driver', 'list', '--installed', '--json'], { cwd, encoding: 'utf-8' });
+    if (r.status !== 0 || !r.stdout)
+        return new Set();
+    try {
+        return new Set(Object.keys(JSON.parse(r.stdout)));
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * Auto-install the Appium PLATFORM drivers needed for ANY session — both the appium-mcp live capture
+ * (`/sungen:create-test`) and the wdio runner (`/sungen:run-test`). Provisioned by the SAME code path
+ * that installs @sungen/driver-mobile (right after its `appium` dep is installed). Best-effort + idempotent.
+ *
+ *   - `uiautomator2` (Android): cross-platform → always.
+ *   - `xcuitest` (iOS): macOS-only — it builds WebDriverAgent via Xcode at RUN time, usable only on a
+ *     Mac → installed only on darwin; elsewhere we print the command for when on a Mac.
+ *
+ * Runs the project-local appium bin directly (NOT `npx`, which would either auto-fetch a latest appium
+ * or hard-fail with `--no-install`). If appium isn't installed in the project, skip with a clear hint.
+ */
+function installAppiumPlatformDrivers(cwd) {
+    const appiumBin = appiumBinPath(cwd);
+    if (!appiumBin) {
+        console.warn('⚠️  appium is not installed in the project — skipping platform-driver install.\n' +
+            '   Install the mobile runtime first (the @sungen/driver-mobile deps via `npm install`), then run:\n' +
+            `     npx appium driver install uiautomator2${process.platform === 'darwin' ? '   (+ xcuitest)' : ''}`);
+        return;
+    }
+    const installed = installedAppiumDrivers(appiumBin, cwd);
+    const want = ['uiautomator2', ...(process.platform === 'darwin' ? ['xcuitest'] : [])];
+    for (const drv of want) {
+        if (installed.has(drv)) {
+            console.log(`✓ appium driver "${drv}" already installed.`);
+            continue;
+        }
+        console.log(`📦 Installing appium driver "${drv}"...`);
+        const r = (0, child_process_1.spawnSync)(appiumBin, ['driver', 'install', drv], { cwd, stdio: 'inherit' });
+        if (!r || r.status !== 0) {
+            console.warn(`⚠️  appium driver "${drv}" not installed (best-effort) — retry: npx appium driver install ${drv}`);
+        }
+    }
+    if (process.platform !== 'darwin') {
+        console.log('ℹ️  iOS (xcuitest) is macOS-only (needs Xcode at run time) — skipped on this OS. On a Mac: npx appium driver install xcuitest');
+    }
+}
+/**
+ * Best-effort provision of the mobile runtime into a project that has opted into mobile
+ * (`sungen init --mobile` / `sungen capability add mobile` — never auto-run; consent-gated).
+ *
+ * Installs everything the runner needs:
+ *   1. `@sungen/driver-mobile` + its WebdriverIO/Appium runtime (declared as that package's `dependencies`).
+ *      A local `file:` spec (dev/dogfood) uses `npm install --install-links` so npm COPIES the package and
+ *      installs its transitive deps — a plain file: install only SYMLINKS it and skips the runtime. A
+ *      published/registry spec installs deps normally.
+ *   2. the appium PLATFORM drivers (uiautomator2 / xcuitest, ~/.appium-managed) — NOT npm packages, so
+ *      installed via the appium CLI here (installAppiumPlatformDrivers), so a session can actually start.
+ *
+ * Non-fatal: logs a warning on failure so offline/air-gapped init still scaffolds correctly.
+ *
+ * @returns true if the driver install succeeded (or was already present), false on failure
+ */
+function installMobileDriver(cwd) {
+    const driverSpec = resolveMobileDriverSpec();
+    // A `file:` spec (unpublished dev/dogfood driver) MUST install with --install-links: a plain file:
+    // install only SYMLINKS the package and skips its transitive deps, so the wdio/appium runtime never
+    // lands in the project. --install-links makes npm COPY it and install those deps. Registry specs
+    // install deps normally, so the flag is omitted there.
+    const isFileSpec = driverSpec.startsWith('file:');
+    // Provisioned only when BOTH the driver dep AND its appium runtime are present — a driver that was
+    // symlinked earlier (no runtime) must be re-installed (with --install-links) to actually pull appium.
+    let hasDriverDep = false;
+    try {
+        const pkgJsonPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(pkgJsonPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            hasDriverDep = !!allDeps['@sungen/driver-mobile'];
+        }
+    }
+    catch {
+        // proceed to install
+    }
+    const runtimeReady = hasDriverDep && appiumBinPath(cwd) !== null;
+    let driverOk = runtimeReady;
+    if (!runtimeReady) {
+        console.log(`📦 Installing mobile driver + runtime (${driverSpec})...`);
+        driverOk = npmInstallDev(cwd, [driverSpec], isFileSpec ? ['--install-links'] : []);
+        if (!driverOk) {
+            console.warn(`⚠️  Could not install ${driverSpec} — scaffold is complete but the mobile driver is not installed.\n` +
+                `   Install manually later: npm install -D ${driverSpec}${isFileSpec ? ' --install-links' : ''}`);
+        }
+    }
+    // Appium platform driver(s) — REQUIRED for any session (appium-mcp live capture AND the wdio runner).
+    // NOT npm packages, so installed via the appium CLI here, by the same code path that installs the driver.
+    installAppiumPlatformDrivers(cwd);
+    return driverOk;
+}
+//# sourceMappingURL=mobile-runtime-scaffolder.js.map

package/dist/orchestrator/mobile-runtime-scaffolder.js.map

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

package/dist/orchestrator/project-initializer.d.ts

@@ -2,13 +2,33 @@
  * Project Initializer
  * Creates essential directory structure for Sungen pipeline
  */
+import { AdapterKey } from './ai-skills/adapters';
+import { MobileInitOptions } from './mobile-runtime-scaffolder';
+export { MobileInitOptions };
 export declare class ProjectInitializer {
     private baseUrl;
     private baseCwd;
     private cwd;
     private createdItems;
     private skippedItems;
-    constructor(baseUrl: string);
+    private agents;
+    private force;
+    private mobile;
+    constructor(baseUrl: string, opts?: {
+        agents?: AdapterKey[];
+        force?: boolean;
+        enabled?: boolean;
+        mobileOnly?: boolean;
+        appPackage?: string;
+        appActivity?: string;
+        appApk?: string;
+        androidUdid?: string;
+        iosBundleId?: string;
+        iosDevice?: string;
+        iosVersion?: string;
+    });
+    /** Mobile-only project: no Playwright/web scaffolding. */
+    private get mobileOnly();
     /**
      * Initialize project with essential directories and config
      */
@@ -18,7 +38,9 @@ export declare class ProjectInitializer {
      */
     private createProjectRoot;
     /**
-     * Create essential directories only
+     * Create essential directories only.
+     * Mobile-only: skips specs/storage (Playwright auth state); qa/screens + qa/flows still created
+     * (1-platform model — mobile uses the same tree as web, NOT a separate qa/mobile/ path).
      */
     private createDirectories;
     /**
@@ -30,7 +52,9 @@ export declare class ProjectInitializer {
      */
     private createTsConfig;
     /**
-     * Update .gitignore with Sungen-specific entries
+     * Update .gitignore with Sungen-specific entries.
+     * Mobile projects add .env.appium (device ids + machine paths) and specs/.auth-mobile/
+     * (Appium auth contract). Web projects add Playwright auth state + report dirs.
      */
     private updateGitignore;
     /**
@@ -38,11 +62,13 @@ export declare class ProjectInitializer {
      */
     private createReadme;
     /**
-     * Create VS Code settings for Copilot auto-attach
+     * Create VS Code settings for Copilot auto-attach.
+     * Mobile-only: approves wdio + npx appium instead of npx playwright.
      */
     private createVSCodeSettings;
     /**
-     * Create root .mcp.json for Claude Code — safe-merge Playwright + Figma entries
+     * Create root .mcp.json for Claude Code.
+     * Mobile-only: appium-mcp instead of Playwright MCP. Figma always included.
      */
     private createClaudeMCPConfig;
     /**
@@ -59,6 +85,10 @@ export declare class ProjectInitializer {
      * Shares `AI_RULES_FILE_MAPPING` with `sungen update` so a newly added
      * skill / command template only needs to be registered once.
      */
+    /**
+     * Create AI rules files for the selected assistants from the single source (ai-src).
+     * Shares the generator (ai-skills/build) with `sungen update` so a skill is authored once.
+     */
     private createAIRules;
     /**
      * Create qa/context.md for the QA lead to fill project-wide context
@@ -66,8 +96,9 @@ export declare class ProjectInitializer {
      */
     private createContext;
     /**
-     * Create qa/capabilities.yaml — the platform driver profile (Phase 2a).
-     * Defaults to `web` (Playwright). Mobile/API projects switch via `sungen capability add`.
+     * Create qa/capabilities.yaml — the platform driver profile.
+     * Web default: platform=web, enabled=[web].
+     * Mobile: platform=mobile, enabled=[mobile] (via writeMobileCapabilities from the scaffolder).
      */
     private createCapabilities;
     /**
@@ -78,6 +109,12 @@ export declare class ProjectInitializer {
      * Create specs/test-data.ts for runtime YAML loading
      */
     private createSpecsTestData;
+    /**
+     * Delegate to mobile-runtime-scaffolder to emit Appium/WDIO harness files,
+     * then best-effort install @sungen/driver-mobile at lockstep version.
+     * Called only when `--mobile` is set.
+     */
+    private emitMobileHarness;
     /**
      * Read a template file from the templates directory
      */

package/dist/orchestrator/project-initializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-initializer.d.ts","sourceRoot":"","sources":["../../src/orchestrator/project-initializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,qBAAa,kBAAkB;IAMjB,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAgB;gBAEhB,OAAO,EAAE,MAAM;IAKnC;;OAEG;IACG,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDrD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyC5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IA4CtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAwBrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAarB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;YACW,iBAAiB;IAsC/B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA0C5B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAInC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}
+{"version":3,"file":"project-initializer.d.ts","sourceRoot":"","sources":["../../src/orchestrator/project-initializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,iBAAiB,EAIlB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAO7B,qBAAa,kBAAkB;IASjB,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,MAAM,CAAoB;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAkBpR,0DAA0D;IAC1D,OAAO,KAAK,UAAU,GAErB;IAED;;OAEG;IACG,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DrD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAmCvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA0C5B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IA4CtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoCtB;;;;OAIG;IACH;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAarB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;YACW,iBAAiB;IA2C/B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgD5B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAInC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}