@shrkcrft/inspector 0.1.0-alpha.1

package/dist/migration-profile-registry.js

@@ -0,0 +1,135 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * Migration profile registry. Loads pack-contributed migration profiles
+ * via `migrationProfileFiles` on pack manifests. Engine ships zero built-ins.
+ */
+import { existsSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { pathToFileURL } from 'node:url';
+export const MIGRATION_PROFILE_REGISTRY_SCHEMA = 'sharkcraft.migration-profile-registry/v1';
+export var MigrationProfileSource;
+(function (MigrationProfileSource) {
+    MigrationProfileSource["Local"] = "local";
+    MigrationProfileSource["Pack"] = "pack";
+})(MigrationProfileSource || (MigrationProfileSource = {}));
+async function importDefault(file) {
+    const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(file).href)));
+    if (Array.isArray(mod.default))
+        return mod.default;
+    if (mod.default && typeof mod.default === 'object')
+        return [mod.default];
+    if (Array.isArray(mod.migrationProfiles))
+        return mod.migrationProfiles;
+    return [];
+}
+function localFiles(inspection) {
+    const out = [];
+    const dir = inspection.sharkcraftDir;
+    if (!dir)
+        return [];
+    for (const name of ['migration-profiles.ts', 'migration-profiles/index.ts']) {
+        const full = nodePath.join(dir, name);
+        if (existsSync(full))
+            out.push(full);
+    }
+    const cfg = inspection.config;
+    for (const rel of cfg?.migrationProfileFiles ?? []) {
+        out.push(nodePath.isAbsolute(rel) ? rel : nodePath.join(dir, rel));
+    }
+    return out;
+}
+function looksValid(raw) {
+    if (!raw || typeof raw !== 'object')
+        return false;
+    const o = raw;
+    return typeof o.id === 'string' && typeof o.title === 'string' && Array.isArray(o.checks);
+}
+export async function loadMigrationProfiles(inspection) {
+    const entries = [];
+    const issues = [];
+    const seen = new Set();
+    const ingest = (raw, source, packageName, sourceFile) => {
+        if (!looksValid(raw)) {
+            issues.push({
+                severity: 'warning',
+                code: 'invalid-profile',
+                message: `Invalid migration profile at ${sourceFile}; skipped.`,
+                source: sourceFile,
+            });
+            return;
+        }
+        if (seen.has(raw.id)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate-id',
+                message: `Migration profile id "${raw.id}" already loaded; skipping ${sourceFile}.`,
+                profileId: raw.id,
+                source: sourceFile,
+            });
+            return;
+        }
+        seen.add(raw.id);
+        entries.push({
+            profile: raw,
+            source,
+            ...(packageName ? { packageName } : {}),
+            sourceFile,
+        });
+    };
+    for (const file of localFiles(inspection)) {
+        try {
+            const list = await importDefault(file);
+            const rel = nodePath.relative(inspection.projectRoot, file) || file;
+            for (const raw of list)
+                ingest(raw, MigrationProfileSource.Local, undefined, rel);
+        }
+        catch (e) {
+            issues.push({
+                severity: 'warning',
+                code: 'load-failed',
+                message: `Failed to load ${file}: ${e.message}`,
+                source: file,
+            });
+        }
+    }
+    for (const pack of inspection.packs.validPacks ?? []) {
+        const contributions = (pack.manifest?.contributions ?? {});
+        for (const rel of contributions.migrationProfileFiles ?? []) {
+            const file = nodePath.resolve(pack.packageRoot, rel);
+            if (!existsSync(file)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'missing-file',
+                    message: `Pack ${pack.packageName} declares migration profile ${rel} but file is missing.`,
+                    source: file,
+                });
+                continue;
+            }
+            try {
+                const list = await importDefault(file);
+                for (const raw of list)
+                    ingest(raw, MigrationProfileSource.Pack, pack.packageName, rel);
+            }
+            catch (e) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'load-failed',
+                    message: `Pack ${pack.packageName} (${rel}): ${e.message}`,
+                    source: file,
+                });
+            }
+        }
+    }
+    return { entries, issues };
+}
+export async function listMigrationProfilesFromPacks(inspection) {
+    const { entries } = await loadMigrationProfiles(inspection);
+    return entries.map((e) => e.profile);
+}

package/dist/migration-readiness.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Generic migration readiness verdict. A migration profile is a list of named
+ * checks that probe local files / reports / config — never running any source
+ * code. The output is a deterministic JSON envelope an agent or a CI gate
+ * can read.
+ *
+ * Migration profiles ship as data via `migrationProfileFiles` on a pack
+ * manifest or via the optional `customProfiles` option below. The SharkCraft
+ * engine no longer ships project-specific built-in profiles.
+ */
+export declare enum MigrationCheckStatus {
+    Pass = "pass",
+    Warn = "warn",
+    Fail = "fail",
+    Skip = "skip"
+}
+export declare enum MigrationVerdict {
+    Blocked = "blocked",
+    ReadyExceptSigning = "ready-except-signing",
+    ReadyExceptBaseline = "ready-except-baseline",
+    ReadyExceptDedupe = "ready-except-dedupe",
+    ReadyExceptScriptSwitch = "ready-except-script-switch",
+    ReadyToDeprecate = "ready-to-deprecate",
+    ReadyToDelete = "ready-to-delete"
+}
+export interface IMigrationCheck {
+    id: string;
+    title: string;
+    description?: string;
+    /** File existence / non-existence / contents probe. Resolved relative to projectRoot. */
+    filePresent?: readonly string[];
+    /** "at least one of" — passes if ANY listed path exists. Useful when a pack/file may live in either of two known locations after a rename. */
+    filePresentAny?: readonly string[];
+    fileAbsent?: readonly string[];
+    /** Required env var; success if set (and non-empty). */
+    envVar?: string;
+    /** Optional category for grouping. */
+    category?: 'pack' | 'parity' | 'baseline' | 'dedupe' | 'scripts' | 'doctor' | 'mcp' | 'playbook' | 'sequence';
+    /** When true, failure does not block — only warns. */
+    optional?: boolean;
+    /** When set, the verdict reason if this exact check fails. */
+    blockerReason?: MigrationVerdict;
+}
+export interface IMigrationProfile {
+    id: string;
+    title: string;
+    description?: string;
+    /** Final verdict (delete-target) name. */
+    successVerdict: MigrationVerdict;
+    checks: readonly IMigrationCheck[];
+}
+export interface IMigrationCheckResult {
+    id: string;
+    title: string;
+    status: MigrationCheckStatus;
+    message: string;
+    category?: IMigrationCheck['category'];
+    optional?: boolean;
+    blockerReason?: MigrationVerdict;
+}
+export interface IMigrationReadinessReport {
+    schema: 'sharkcraft.migration-readiness/v1';
+    generatedAt: string;
+    projectRoot: string;
+    profileId: string;
+    profileTitle: string;
+    verdict: MigrationVerdict;
+    ready: boolean;
+    blockers: readonly IMigrationCheckResult[];
+    warnings: readonly IMigrationCheckResult[];
+    passed: readonly IMigrationCheckResult[];
+    skipped: readonly IMigrationCheckResult[];
+    checklist: readonly string[];
+}
+export interface IMigrationReadinessOptions {
+    profileId: string;
+    projectRoot: string;
+    /**
+     * Additional migration profiles to consult when resolving `profileId`.
+     * Pack-loaded profiles arrive here from the CLI/MCP entrypoints; tests pass
+     * fixture profiles directly.
+     */
+    customProfiles?: readonly IMigrationProfile[];
+}
+export interface IMigrationReadinessResolveResult {
+    ok: boolean;
+    profile?: IMigrationProfile;
+    error?: string;
+}
+export declare function resolveMigrationProfile(profileId: string, customProfiles?: readonly IMigrationProfile[]): IMigrationReadinessResolveResult;
+export declare function listMigrationProfiles(customProfiles?: readonly IMigrationProfile[]): readonly IMigrationProfile[];
+declare function checkOne(check: IMigrationCheck, projectRoot: string): IMigrationCheckResult;
+export declare function buildMigrationReadiness(options: IMigrationReadinessOptions): IMigrationReadinessReport;
+export declare function renderMigrationReadinessText(report: IMigrationReadinessReport): string;
+export declare function renderMigrationReadinessMarkdown(report: IMigrationReadinessReport): string;
+export declare const __testing: {
+    resolveMigrationProfile: typeof resolveMigrationProfile;
+    checkOne: typeof checkOne;
+};
+export {};
+//# sourceMappingURL=migration-readiness.d.ts.map

package/dist/migration-readiness.d.ts.map

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

package/dist/migration-readiness.js

@@ -0,0 +1,253 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+/**
+ * Generic migration readiness verdict. A migration profile is a list of named
+ * checks that probe local files / reports / config — never running any source
+ * code. The output is a deterministic JSON envelope an agent or a CI gate
+ * can read.
+ *
+ * Migration profiles ship as data via `migrationProfileFiles` on a pack
+ * manifest or via the optional `customProfiles` option below. The SharkCraft
+ * engine no longer ships project-specific built-in profiles.
+ */
+export var MigrationCheckStatus;
+(function (MigrationCheckStatus) {
+    MigrationCheckStatus["Pass"] = "pass";
+    MigrationCheckStatus["Warn"] = "warn";
+    MigrationCheckStatus["Fail"] = "fail";
+    MigrationCheckStatus["Skip"] = "skip";
+})(MigrationCheckStatus || (MigrationCheckStatus = {}));
+export var MigrationVerdict;
+(function (MigrationVerdict) {
+    MigrationVerdict["Blocked"] = "blocked";
+    MigrationVerdict["ReadyExceptSigning"] = "ready-except-signing";
+    MigrationVerdict["ReadyExceptBaseline"] = "ready-except-baseline";
+    MigrationVerdict["ReadyExceptDedupe"] = "ready-except-dedupe";
+    MigrationVerdict["ReadyExceptScriptSwitch"] = "ready-except-script-switch";
+    MigrationVerdict["ReadyToDeprecate"] = "ready-to-deprecate";
+    MigrationVerdict["ReadyToDelete"] = "ready-to-delete";
+})(MigrationVerdict || (MigrationVerdict = {}));
+const BUILTIN_PROFILES = Object.freeze({});
+export function resolveMigrationProfile(profileId, customProfiles = []) {
+    const custom = customProfiles.find((p) => p.id === profileId);
+    const profile = BUILTIN_PROFILES[profileId] ?? custom;
+    if (!profile) {
+        const known = [...Object.keys(BUILTIN_PROFILES), ...customProfiles.map((p) => p.id)];
+        return {
+            ok: false,
+            error: `Unknown migration profile: ${profileId}. Known: ${known.join(', ') || '(none — provide a customProfiles entry or pack-contributed migrationProfileFiles)'}`,
+        };
+    }
+    return { ok: true, profile };
+}
+export function listMigrationProfiles(customProfiles = []) {
+    return [...Object.values(BUILTIN_PROFILES), ...customProfiles];
+}
+function checkOne(check, projectRoot) {
+    const fails = [];
+    if (check.filePresent) {
+        for (const rel of check.filePresent) {
+            const abs = nodePath.join(projectRoot, rel);
+            if (!existsSync(abs))
+                fails.push(`missing: ${rel}`);
+        }
+    }
+    if (check.filePresentAny) {
+        const hits = check.filePresentAny.filter((rel) => existsSync(nodePath.join(projectRoot, rel)));
+        if (hits.length === 0) {
+            fails.push(`none of: ${check.filePresentAny.join(', ')}`);
+        }
+    }
+    if (check.fileAbsent) {
+        for (const rel of check.fileAbsent) {
+            const abs = nodePath.join(projectRoot, rel);
+            if (existsSync(abs))
+                fails.push(`should be absent: ${rel}`);
+        }
+    }
+    if (check.envVar) {
+        const value = process.env[check.envVar];
+        if (!value || value.length === 0)
+            fails.push(`env ${check.envVar} not set`);
+    }
+    if (fails.length === 0) {
+        return {
+            id: check.id,
+            title: check.title,
+            status: MigrationCheckStatus.Pass,
+            message: 'ok',
+            ...(check.category ? { category: check.category } : {}),
+            ...(check.optional ? { optional: true } : {}),
+            ...(check.blockerReason ? { blockerReason: check.blockerReason } : {}),
+        };
+    }
+    const status = check.optional ? MigrationCheckStatus.Warn : MigrationCheckStatus.Fail;
+    return {
+        id: check.id,
+        title: check.title,
+        status,
+        message: fails.join('; '),
+        ...(check.category ? { category: check.category } : {}),
+        ...(check.optional ? { optional: true } : {}),
+        ...(check.blockerReason ? { blockerReason: check.blockerReason } : {}),
+    };
+}
+export function buildMigrationReadiness(options) {
+    const { profileId, projectRoot, customProfiles } = options;
+    const resolved = resolveMigrationProfile(profileId, customProfiles ?? []);
+    if (!resolved.ok || !resolved.profile) {
+        return {
+            schema: 'sharkcraft.migration-readiness/v1',
+            generatedAt: new Date().toISOString(),
+            projectRoot,
+            profileId,
+            profileTitle: '(unknown profile)',
+            verdict: MigrationVerdict.Blocked,
+            ready: false,
+            blockers: [
+                {
+                    id: 'profile-unknown',
+                    title: 'Unknown migration profile',
+                    status: MigrationCheckStatus.Fail,
+                    message: resolved.error ?? 'unknown profile',
+                },
+            ],
+            warnings: [],
+            passed: [],
+            skipped: [],
+            checklist: [],
+        };
+    }
+    const profile = resolved.profile;
+    const blockers = [];
+    const warnings = [];
+    const passed = [];
+    const skipped = [];
+    for (const check of profile.checks) {
+        const r = checkOne(check, projectRoot);
+        if (r.status === MigrationCheckStatus.Fail)
+            blockers.push(r);
+        else if (r.status === MigrationCheckStatus.Warn)
+            warnings.push(r);
+        else if (r.status === MigrationCheckStatus.Skip)
+            skipped.push(r);
+        else
+            passed.push(r);
+    }
+    // Verdict resolution: pick the most-specific blocker reason if a non-warn
+    // failure exists; otherwise the success verdict.
+    let verdict = profile.successVerdict;
+    let ready = true;
+    if (blockers.length > 0) {
+        ready = false;
+        // Prefer a specific "ready-except-*" verdict over the generic "blocked".
+        const specific = blockers.find((b) => b.blockerReason && b.blockerReason !== MigrationVerdict.Blocked);
+        verdict = specific?.blockerReason ?? blockers[0]?.blockerReason ?? MigrationVerdict.Blocked;
+    }
+    else if (warnings.length > 0) {
+        // All required checks passed; warnings mean we can deprecate but maybe not
+        // delete immediately. Downgrade to ReadyToDeprecate when the success verdict
+        // is ReadyToDelete.
+        if (profile.successVerdict === MigrationVerdict.ReadyToDelete) {
+            verdict = MigrationVerdict.ReadyToDeprecate;
+        }
+        else {
+            verdict = profile.successVerdict;
+        }
+    }
+    const checklist = [
+        `Profile: ${profile.title} (${profile.id})`,
+        `Verdict: ${verdict}`,
+        `Passed: ${passed.length}, Warnings: ${warnings.length}, Blockers: ${blockers.length}`,
+        'Next: review blockers (if any), then re-run `shrk migration readiness --profile ' +
+            profile.id +
+            '`.',
+    ];
+    return {
+        schema: 'sharkcraft.migration-readiness/v1',
+        generatedAt: new Date().toISOString(),
+        projectRoot,
+        profileId,
+        profileTitle: profile.title,
+        verdict,
+        ready,
+        blockers,
+        warnings,
+        passed,
+        skipped,
+        checklist,
+    };
+}
+export function renderMigrationReadinessText(report) {
+    const lines = [];
+    lines.push(`=== Migration readiness — ${report.profileTitle} ===`);
+    lines.push(`  profile  ${report.profileId}`);
+    lines.push(`  verdict  ${report.verdict}`);
+    lines.push(`  ready    ${report.ready ? 'yes' : 'no'}`);
+    lines.push(`  passed   ${report.passed.length}`);
+    lines.push(`  warnings ${report.warnings.length}`);
+    lines.push(`  blockers ${report.blockers.length}`);
+    lines.push('');
+    const groups = [
+        ['BLOCKERS', report.blockers],
+        ['WARNINGS', report.warnings],
+        ['PASSED', report.passed],
+        ['SKIPPED', report.skipped],
+    ];
+    for (const [groupTitle, items] of groups) {
+        if (items.length === 0)
+            continue;
+        lines.push(groupTitle);
+        for (const item of items) {
+            const cat = item.category ? `[${item.category}] ` : '';
+            lines.push(`  - ${item.status.padEnd(5)} ${cat}${item.id.padEnd(28)} ${item.title}`);
+            if (item.message && item.message !== 'ok')
+                lines.push(`            ↳ ${item.message}`);
+        }
+        lines.push('');
+    }
+    lines.push('Checklist:');
+    for (const item of report.checklist)
+        lines.push(`  • ${item}`);
+    return lines.join('\n') + '\n';
+}
+export function renderMigrationReadinessMarkdown(report) {
+    const lines = [];
+    lines.push(`# Migration readiness — ${report.profileTitle}`);
+    lines.push('');
+    lines.push(`- **Profile:** \`${report.profileId}\``);
+    lines.push(`- **Verdict:** \`${report.verdict}\``);
+    lines.push(`- **Ready:** ${report.ready ? '✅' : '❌'}`);
+    lines.push(`- Passed: ${report.passed.length}, Warnings: ${report.warnings.length}, Blockers: ${report.blockers.length}`);
+    lines.push('');
+    const groups = [
+        ['Blockers', report.blockers],
+        ['Warnings', report.warnings],
+        ['Passed', report.passed],
+        ['Skipped', report.skipped],
+    ];
+    for (const [groupTitle, items] of groups) {
+        if (items.length === 0)
+            continue;
+        lines.push(`## ${groupTitle}`);
+        lines.push('');
+        lines.push('| Status | Category | ID | Title | Detail |');
+        lines.push('|---|---|---|---|---|');
+        for (const item of items) {
+            lines.push(`| ${item.status} | ${item.category ?? ''} | \`${item.id}\` | ${item.title} | ${item.message === 'ok' ? '' : item.message} |`);
+        }
+        lines.push('');
+    }
+    lines.push('## Checklist');
+    lines.push('');
+    for (const c of report.checklist)
+        lines.push(`- ${c}`);
+    return lines.join('\n') + '\n';
+}
+// Tiny helpers exported for tests.
+export const __testing = {
+    resolveMigrationProfile,
+    checkOne,
+};
+void readFileSync;
+void statSync;

package/dist/monorepo-onboarding.d.ts

@@ -0,0 +1,51 @@
+import { type IWorkspaceSummary } from '@shrkcrft/workspace';
+export interface IMonorepoPackage {
+    /** Package root relative to project root, e.g. "apps/web", "packages/core". */
+    path: string;
+    /** Group the package belongs to (apps / packages / libs). */
+    group: 'apps' | 'packages' | 'libs';
+    /** Name from the package.json (when present). */
+    name?: string;
+    /** Detected scripts (test/build/lint/typecheck only). */
+    scripts: Readonly<Record<string, string>>;
+    /** Whether the package has its own tsconfig.json. */
+    hasTsConfig: boolean;
+}
+export interface IMonorepoBoundaryCandidate {
+    id: string;
+    title: string;
+    from: readonly string[];
+    forbiddenImports: readonly string[];
+    reason: string;
+}
+export interface IMonorepoVerificationHint {
+    packagePath: string;
+    /** Script id (e.g. test, lint). */
+    script: string;
+    /** Suggested command, e.g. "bun --cwd packages/core run test". */
+    command: string;
+}
+export interface IMonorepoSummary {
+    /** Project root (absolute). */
+    rootPath: string;
+    /** Manager-detected workspaces array from package.json (raw globs). */
+    workspaces: readonly string[];
+    /** All discovered apps. */
+    apps: readonly IMonorepoPackage[];
+    /** All discovered packages. */
+    packages: readonly IMonorepoPackage[];
+    /** All discovered libs. */
+    libs: readonly IMonorepoPackage[];
+    /** Recommended root-level verification commands (deduped). */
+    rootVerificationCommands: readonly string[];
+    /** Per-package verification hints. */
+    perPackageVerificationHints: readonly IMonorepoVerificationHint[];
+    /** Layer/group boundary candidates derived from the layout. */
+    boundaryCandidates: readonly IMonorepoBoundaryCandidate[];
+    /** Preset ids worth recommending for a monorepo root. */
+    presetRecommendations: readonly string[];
+    /** Short narrative summary lines. */
+    notes: readonly string[];
+}
+export declare function buildMonorepoSummary(ws: IWorkspaceSummary, subDirs: ReadonlyMap<string, readonly string[]>): IMonorepoSummary | null;
+//# sourceMappingURL=monorepo-onboarding.d.ts.map

package/dist/monorepo-onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-onboarding.d.ts","sourceRoot":"","sources":["../src/monorepo-onboarding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACpC,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,2BAA2B;IAC3B,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClC,+BAA+B;IAC/B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,2BAA2B;IAC3B,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClC,8DAA8D;IAC9D,wBAAwB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,sCAAsC;IACtC,2BAA2B,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAClE,+DAA+D;IAC/D,kBAAkB,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC1D,yDAAyD;IACzD,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,qCAAqC;IACrC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAmBD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,GAC9C,gBAAgB,GAAG,IAAI,CA+DzB"}