ysk-server-core 1.0.0

package/dist/hosting/software-probe/resolve-bin.js

@@ -0,0 +1,168 @@
+/**
+ * Single PATH / absolute-path binary resolution for host probes.
+ * Do not re-implement command -v elsewhere for product software.
+ */
+/** Standard PATH used for all product software probes */
+export const PROBE_PATH = '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/cargo/bin';
+/**
+ * Bash snippet: prepend YSK toolchain bins (node/go/bun/python) so probes find
+ * installs under /usr/local/ysk even when not symlinked into /usr/local/bin.
+ *
+ * Safe under `set -u` / `set -e` (used inside install.sh via shellBinExists).
+ * Avoids `for x in empty-glob` unbound-variable failures on some bash + nullglob.
+ */
+export function shellPrependYskToolchainPath() {
+    // Build globs without */ inside block comments (esbuild).
+    const nodeGlob = '/usr/local/ysk/node/' + '*/bin';
+    const goGlob = '/usr/local/ysk/go/' + '*/bin';
+    const pyGlob = '/usr/local/ysk/python/' + '*/bin';
+    const bunBin = '/usr/local/ysk/bun/bin';
+    return [
+        'export PATH="' + PROBE_PATH + ':${HOME:-}/.cargo/bin:${PATH:-}"',
+        // ls -d: no match → empty + exit 1; || true keeps set -e happy
+        `_ysk_extra="$(ls -d ${nodeGlob} ${goGlob} ${pyGlob} ${bunBin} 2>/dev/null | tr '\\n' ':' | sed 's/:$//')" || true`,
+        'if [ -n "${_ysk_extra:-}" ]; then export PATH="${_ysk_extra}:$PATH"; fi',
+        'unset _ysk_extra 2>/dev/null || true',
+    ].join('\n');
+}
+export function absoluteBinCandidates(bin) {
+    return [
+        `/usr/local/sbin/${bin}`,
+        `/usr/local/bin/${bin}`,
+        `/usr/sbin/${bin}`,
+        `/usr/bin/${bin}`,
+        `/sbin/${bin}`,
+        `/bin/${bin}`,
+        `/usr/local/cargo/bin/${bin}`,
+    ];
+}
+/**
+ * Debian/Ubuntu PostgreSQL ships versioned binaries outside PATH, e.g.
+ * /usr/lib/postgresql/16/bin/postgres — not on /usr/bin.
+ */
+const PG_VERSIONED_BINS = new Set([
+    'postgres',
+    'pg_ctl',
+    'initdb',
+    'pg_isready',
+    'pg_dump',
+    'pg_restore',
+    'createdb',
+    'dropdb',
+    'createuser',
+    'dropuser',
+]);
+async function resolvePostgresVersionedBin(host, bin) {
+    if (!PG_VERSIONED_BINS.has(bin))
+        return '';
+    try {
+        const r = await host.runCommand([
+            'bash',
+            '-c',
+            // Prefer highest version; paths are fixed under /usr/lib/postgresql
+            `ls -1 /usr/lib/postgresql/*/bin/${bin} 2>/dev/null | sort -V | tail -n 1 || true`,
+        ], { timeoutMs: 5_000 });
+        const p = r.stdout.trim().split('\n').filter(Boolean).pop()?.trim() ?? '';
+        if (p.startsWith('/') && host.pathExists(p))
+            return p;
+    }
+    catch {
+        /* ignore */
+    }
+    return '';
+}
+/**
+ * Resolve a bare binary name to an absolute path if present on the host.
+ * Returns empty string when missing.
+ */
+export async function resolveBin(host, bin) {
+    if (!bin || /[^a-zA-Z0-9._+-]/.test(bin))
+        return '';
+    try {
+        const r = await host.runCommand([
+            'bash',
+            '-c',
+            `${shellPrependYskToolchainPath()}\ncommand -v ${bin} 2>/dev/null || true`,
+        ], { timeoutMs: 5_000 });
+        const fromPath = r.stdout.trim().split('\n')[0]?.trim() ?? '';
+        // Reject non-path noise (legacy mocks returned "yes"/"no")
+        if (fromPath.startsWith('/') || fromPath.includes('/'))
+            return fromPath;
+    }
+    catch {
+        /* host error → missing */
+    }
+    for (const p of absoluteBinCandidates(bin)) {
+        try {
+            if (host.pathExists(p))
+                return p;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    const pg = await resolvePostgresVersionedBin(host, bin);
+    if (pg)
+        return pg;
+    return '';
+}
+/** Whether a bare binary name exists (product-wide standard). */
+export async function binPresent(host, bin) {
+    return (await resolveBin(host, bin)).length > 0;
+}
+export async function unitIsActive(host, unit) {
+    try {
+        if (!host.pathExists('/bin/systemctl') && !host.pathExists('/usr/bin/systemctl')) {
+            return undefined;
+        }
+        const r = await host.runCommand(['systemctl', 'is-active', unit], { timeoutMs: 5_000 });
+        return (r.stdout || r.stderr || '').trim().split('\n')[0] || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function unitIsEnabled(host, unit) {
+    try {
+        if (!host.pathExists('/bin/systemctl') && !host.pathExists('/usr/bin/systemctl')) {
+            return undefined;
+        }
+        const r = await host.runCommand(['systemctl', 'is-enabled', unit], { timeoutMs: 5_000 });
+        return (r.stdout || r.stderr || '').trim().split('\n')[0] || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Poll systemctl is-active until active (or timeout).
+ * Treats `activating` as transient; `failed` aborts early.
+ */
+export async function waitUnitActive(host, unit, opts) {
+    const timeoutMs = opts?.timeoutMs ?? 120_000;
+    const pollMs = opts?.pollMs ?? 1_500;
+    const start = Date.now();
+    let last = 'unknown';
+    while (Date.now() - start < timeoutMs) {
+        last = (await unitIsActive(host, unit)) ?? 'unknown';
+        if (last === 'active') {
+            return { ok: true, active: last, notes: [] };
+        }
+        if (last === 'failed') {
+            return {
+                ok: false,
+                active: last,
+                notes: [`unit ${unit} failed while waiting for active`],
+            };
+        }
+        await new Promise((r) => setTimeout(r, pollMs));
+    }
+    return {
+        ok: last === 'active',
+        active: last,
+        notes: last === 'active'
+            ? []
+            : [`unit ${unit} still ${last} after ${timeoutMs}ms (expected active)`],
+    };
+}
+//# sourceMappingURL=resolve-bin.js.map

package/dist/hosting/software-probe/resolve-bin.js.map

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

package/dist/hosting/software-probe/shell.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Single source of truth for **shell** binary probes (remote scripts, bash -c fragments).
+ * Must stay aligned with resolve-bin.ts PROBE_PATH.
+ *
+ * TypeScript host probes use resolveBin/binPresent; generated bash uses these helpers only.
+ */
+/** export PATH used by every shell probe fragment (includes ysk toolchain bin dirs) */
+export declare function shellProbePathExport(): string;
+/**
+ * True if bin is on probe PATH (exit 0 of the fragment when used with `if …; then`).
+ * Example: `if ${shellBinExists('nginx')}; then …`
+ */
+export declare function shellBinExists(bin: string): string;
+/**
+ * Echo absolute path or empty. For capture: `BIN=$(${shellResolveBin('node')})`
+ */
+export declare function shellResolveBin(bin: string): string;
+/** `if ! has; then fail` style message */
+export declare function shellRequireBin(bin: string, failEcho: string): string;
+/** Install-if-missing apt pattern (product apply scripts) */
+export declare function shellEnsureAptPackage(bin: string, packages: string): string;
+//# sourceMappingURL=shell.d.ts.map

package/dist/hosting/software-probe/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/hosting/software-probe/shell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/hosting/software-probe/shell.js

@@ -0,0 +1,41 @@
+/**
+ * Single source of truth for **shell** binary probes (remote scripts, bash -c fragments).
+ * Must stay aligned with resolve-bin.ts PROBE_PATH.
+ *
+ * TypeScript host probes use resolveBin/binPresent; generated bash uses these helpers only.
+ */
+import { shellPrependYskToolchainPath } from './resolve-bin.js';
+/** export PATH used by every shell probe fragment (includes ysk toolchain bin dirs) */
+export function shellProbePathExport() {
+    return shellPrependYskToolchainPath();
+}
+/**
+ * True if bin is on probe PATH (exit 0 of the fragment when used with `if …; then`).
+ * Example: `if ${shellBinExists('nginx')}; then …`
+ */
+export function shellBinExists(bin) {
+    const safe = sanitizeBin(bin);
+    return `( ${shellProbePathExport()}; command -v ${safe} >/dev/null 2>&1 )`;
+}
+/**
+ * Echo absolute path or empty. For capture: `BIN=$(${shellResolveBin('node')})`
+ */
+export function shellResolveBin(bin) {
+    const safe = sanitizeBin(bin);
+    return `( ${shellProbePathExport()}; command -v ${safe} 2>/dev/null || true )`;
+}
+/** `if ! has; then fail` style message */
+export function shellRequireBin(bin, failEcho) {
+    return `if ! ${shellBinExists(bin)}; then echo ${JSON.stringify(failEcho)}; exit 2; fi`;
+}
+/** Install-if-missing apt pattern (product apply scripts) */
+export function shellEnsureAptPackage(bin, packages) {
+    return `if ! ${shellBinExists(bin)}; then export DEBIAN_FRONTEND=noninteractive; apt-get update -qq && apt-get install -y ${packages}; fi`;
+}
+function sanitizeBin(bin) {
+    if (!bin || /[^a-zA-Z0-9._+-]/.test(bin)) {
+        throw new Error(`invalid bin name for shell probe: ${bin}`);
+    }
+    return bin;
+}
+//# sourceMappingURL=shell.js.map

package/dist/hosting/software-probe/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/hosting/software-probe/shell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEhE,uFAAuF;AACvF,MAAM,UAAU,oBAAoB;IAClC,OAAO,4BAA4B,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,oBAAoB,EAAE,gBAAgB,IAAI,oBAAoB,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,oBAAoB,EAAE,gBAAgB,IAAI,wBAAwB,CAAC;AACjF,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,QAAgB;IAC3D,OAAO,QAAQ,cAAc,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;AAC1F,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,QAAgB;IACjE,OAAO,QAAQ,cAAc,CAAC,GAAG,CAAC,0FAA0F,QAAQ,MAAM,CAAC;AAC7I,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/hosting/software-probe/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Unified software probe contracts — presence / version / upgrade.
+ * All product "is installed?" checks must go through HostSoftwareProbe.
+ */
+export type SoftwareProbeId = string;
+export type SoftwarePresence = {
+    id: SoftwareProbeId;
+    /** Product-semantic installed (honors exclusive packages e.g. mysql vs mariadb) */
+    installed: boolean;
+    /** Absolute paths of bins found */
+    resolvedBins: string[];
+    /** Catalog bins not found */
+    missingBins: string[];
+    /** If another exclusive package owns the host (e.g. mariadb-server) */
+    blockedByExclusive?: string;
+    packagesPresent?: string[];
+    units?: Array<{
+        name: string;
+        active?: string;
+        enabled?: string;
+    }>;
+    notes: string[];
+};
+export type SoftwareVersionInfo = {
+    id: SoftwareProbeId;
+    installed: boolean;
+    version?: string;
+    raw?: string;
+    source: 'cli' | 'dpkg' | 'unknown';
+    notes: string[];
+};
+export type SoftwareUpgradeInfo = {
+    id: SoftwareProbeId;
+    packageName: string;
+    installed: boolean;
+    currentVersion?: string;
+    candidateVersion?: string;
+    upgradable: boolean;
+    source: 'apt' | 'none';
+    notes: string[];
+};
+export type ProbeRegistryEntry = {
+    id: SoftwareProbeId;
+    title: string;
+    bins: string[];
+    aptPackages: string[];
+    units?: string[];
+    /** Other probe ids that cannot coexist as "this" server */
+    exclusiveWith?: string[];
+    /** CLI for version, e.g. ['nginx','-v'] or ['mysql','--version'] */
+    versionCommand?: string[];
+    /** Prefer dpkg package name for version/upgrade */
+    dpkgPackage?: string;
+    /** When true, presence requires exclusive flavor match (server packages) */
+    requiresExclusiveFlavor?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/hosting/software-probe/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hosting/software-probe/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,eAAe,CAAC;IACpB,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,eAAe,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC"}

package/dist/hosting/software-probe/types.js

@@ -0,0 +1,6 @@
+/**
+ * Unified software probe contracts — presence / version / upgrade.
+ * All product "is installed?" checks must go through HostSoftwareProbe.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hosting/software-probe/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hosting/software-probe/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/hosting/software-uninstall.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Feature / catalog software uninstall with impact preview.
+ * Shares apt remove/purge patterns with stack uninstall.
+ */
+import type { HostExecutor } from '../host/executor.js';
+import { type SoftwareInstallStep, type SoftwareStatus } from './software-install.js';
+export type UninstallDataPolicy = 'keep' | 'purge';
+export type UninstallTarget = {
+    id: string;
+    title: string;
+    installed: boolean;
+    packages: string[];
+    units: string[];
+    dataPaths: string[];
+    impactKeys: string[];
+    protected: boolean;
+    installer?: string;
+};
+export type UninstallPreview = {
+    ok: boolean;
+    targets: UninstallTarget[];
+    summary: {
+        packageCount: number;
+        unitCount: number;
+        installedCount: number;
+        willStopServices: boolean;
+        willTouchData: boolean;
+    };
+    warningKeys: string[];
+    confirmPhrase: string;
+    blocked?: boolean;
+    blockMessage?: string;
+    notes: string[];
+};
+export type UninstallResult = {
+    ok: boolean;
+    executed: boolean;
+    blocked?: boolean;
+    blockMessage?: string;
+    requiresExecute?: boolean;
+    dataPolicy: UninstallDataPolicy;
+    targets: string[];
+    steps: SoftwareInstallStep[];
+    notes: string[];
+    statuses: SoftwareStatus[];
+};
+export declare function resolveUninstallIds(input: {
+    feature?: string;
+    ids?: string[];
+}): string[];
+export declare function previewSoftwareUninstall(input: {
+    host: HostExecutor;
+    feature?: string;
+    ids?: string[];
+    dataPolicy?: UninstallDataPolicy;
+}): Promise<UninstallPreview>;
+export declare function uninstallSoftware(input: {
+    host: HostExecutor;
+    feature?: string;
+    ids?: string[];
+    dataPolicy?: UninstallDataPolicy;
+    /** Must match preview confirmPhrase */
+    confirmPhrase?: string;
+    /** Optional live log */
+    onLog?: (stream: 'stdout' | 'stderr' | 'status', line: string) => void;
+}): Promise<UninstallResult>;
+//# sourceMappingURL=software-uninstall.d.ts.map

package/dist/hosting/software-uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-uninstall.d.ts","sourceRoot":"","sources":["../../src/hosting/software-uninstall.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAYF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,MAAM,EAAE,CAQX;AAmBD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuE5B;AAiKD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE,GAAG,OAAO,CAAC,eAAe,CAAC,CA8F3B"}