@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/build/npm-package.js

@@ -0,0 +1,128 @@
+/**
+ * M4-2: npm bundling & registry publication
+ * Generates package.json content and validates npm publication readiness.
+ */
+const DEFAULT_FILES = [
+    'dist/',
+    'README.md',
+    'LICENSE',
+    'CHANGELOG.md',
+];
+const DEFAULT_EXPORTS = {
+    '.': {
+        import: './dist/index.js',
+        types: './dist/index.d.ts',
+    },
+    './config': {
+        import: './dist/config/index.js',
+        types: './dist/config/index.d.ts',
+    },
+    './agents': {
+        import: './dist/agents/onboarding.js',
+        types: './dist/agents/onboarding.d.ts',
+    },
+    './skills': {
+        import: './dist/skills/index.js',
+        types: './dist/skills/index.d.ts',
+    },
+    './runtime': {
+        import: './dist/runtime/config.js',
+        types: './dist/runtime/config.d.ts',
+    },
+};
+/**
+ * Generate package.json content suitable for npm publication.
+ */
+export function generatePackageJson(config) {
+    const exports = {};
+    for (const [key, value] of Object.entries(config.exports)) {
+        if (typeof value === 'string') {
+            exports[key] = { import: value, types: value.replace(/\.js$/, '.d.ts') };
+        }
+        else {
+            exports[key] = { ...value };
+        }
+    }
+    return {
+        name: config.name,
+        version: config.version,
+        description: config.description,
+        type: 'module',
+        main: './dist/index.js',
+        types: './dist/index.d.ts',
+        exports,
+        ...(config.bin && Object.keys(config.bin).length > 0 ? { bin: { ...config.bin } } : {}),
+        files: [...DEFAULT_FILES],
+        ...(config.peerDependencies && Object.keys(config.peerDependencies).length > 0
+            ? { peerDependencies: { ...config.peerDependencies } }
+            : {}),
+        engines: config.engines ? { ...config.engines } : { node: '>=20.0.0' },
+        license: 'MIT',
+        repository: { type: 'git', url: 'https://github.com/bradygaster/squad.git' },
+        keywords: ['copilot', 'multi-agent', 'squad', 'sdk'],
+    };
+}
+/**
+ * Validate a package.json object for npm publication readiness.
+ */
+export function validatePackageJson(pkg) {
+    const errors = [];
+    const warnings = [];
+    if (!pkg.name || typeof pkg.name !== 'string') {
+        errors.push('Missing or invalid "name" field');
+    }
+    else {
+        if (!/^(@[a-z0-9-]+\/)?[a-z0-9._-]+$/.test(pkg.name)) {
+            errors.push(`Invalid package name: ${pkg.name}`);
+        }
+    }
+    if (!pkg.version || typeof pkg.version !== 'string') {
+        errors.push('Missing or invalid "version" field');
+    }
+    else {
+        if (!/^\d+\.\d+\.\d+/.test(pkg.version)) {
+            errors.push(`Invalid semver version: ${pkg.version}`);
+        }
+    }
+    if (!pkg.description || typeof pkg.description !== 'string') {
+        warnings.push('Missing "description" field');
+    }
+    if (!pkg.license || typeof pkg.license !== 'string') {
+        warnings.push('Missing "license" field');
+    }
+    if (!pkg.exports || typeof pkg.exports !== 'object') {
+        errors.push('Missing "exports" map — required for ESM packages');
+    }
+    else {
+        const exports = pkg.exports;
+        if (!exports['.']) {
+            errors.push('Exports map missing "." entry point');
+        }
+    }
+    if (pkg.type !== 'module') {
+        warnings.push('"type" should be "module" for ESM packages');
+    }
+    if (!pkg.files || !Array.isArray(pkg.files) || pkg.files.length === 0) {
+        warnings.push('Missing "files" field — all files will be published');
+    }
+    if (!pkg.engines || typeof pkg.engines !== 'object') {
+        warnings.push('Missing "engines" field — specify Node.js version requirement');
+    }
+    if (!pkg.repository || typeof pkg.repository !== 'object') {
+        warnings.push('Missing "repository" field');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Return the files array for package.json publication.
+ */
+export function getPublishFiles() {
+    return [...DEFAULT_FILES];
+}
+/**
+ * Return the default ESM exports map for the SDK.
+ */
+export function getDefaultExports() {
+    return JSON.parse(JSON.stringify(DEFAULT_EXPORTS));
+}
+//# sourceMappingURL=npm-package.js.map

package/dist/build/npm-package.js.map

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

package/dist/build/release.d.ts

@@ -0,0 +1,108 @@
+/**
+ * M6-13: Release candidate build & validation
+ * Handles release manifest creation, validation, and release notes generation.
+ *
+ * @module build/release
+ */
+import type { CommitInfo } from './versioning.js';
+/** Release channel. */
+export type ReleaseChannel = 'stable' | 'rc' | 'beta' | 'alpha';
+/**
+ * Configuration for creating a release.
+ */
+export interface ReleaseConfig {
+    /** Semver version string (e.g. "1.0.0", "1.0.0-rc.1") */
+    version: string;
+    /** Release channel */
+    channel: ReleaseChannel;
+    /** Whether this is a prerelease */
+    prerelease: boolean;
+    /** Git tag name (e.g. "v1.0.0-rc.1") */
+    tag: string;
+}
+/**
+ * An artifact included in a release.
+ */
+export interface ReleaseArtifact {
+    /** Display name */
+    name: string;
+    /** File path */
+    path: string;
+    /** File size in bytes */
+    size: number;
+    /** SHA-256 hash */
+    sha256: string;
+}
+/**
+ * Release manifest describing a complete release.
+ */
+export interface ReleaseManifest {
+    /** Semver version */
+    version: string;
+    /** Release channel */
+    channel: ReleaseChannel;
+    /** Build artifacts */
+    artifacts: ReleaseArtifact[];
+    /** ISO timestamp of the release */
+    timestamp: string;
+    /** Changelog markdown for this release */
+    changelog: string;
+}
+/**
+ * A validation error found in a release manifest.
+ */
+export interface ReleaseValidationError {
+    /** Field that failed validation */
+    field: string;
+    /** Error message */
+    message: string;
+    /** Severity */
+    severity: 'error' | 'warning';
+}
+/**
+ * A checklist item for the release process.
+ */
+export interface ReleaseChecklistItem {
+    /** Human-readable name */
+    name: string;
+    /** Function that checks this item (returns true if passing) */
+    check: () => boolean;
+    /** Whether this item is required for release */
+    required: boolean;
+    /** Current status */
+    status: 'pass' | 'fail' | 'skip';
+}
+/**
+ * Compute the SHA-256 hash of a buffer or string.
+ */
+export declare function computeSha256(data: Buffer | string): string;
+/**
+ * Build a ReleaseArtifact from a file path.
+ * Returns null if the file does not exist.
+ */
+export declare function buildArtifact(name: string, filePath: string): ReleaseArtifact | null;
+/**
+ * Create a release manifest from a ReleaseConfig.
+ *
+ * @param config - Release configuration
+ * @param artifactPaths - Optional map of artifact name → file path
+ * @returns Release manifest
+ */
+export declare function createRelease(config: ReleaseConfig, artifactPaths?: Record<string, string>): ReleaseManifest;
+/**
+ * Validate a release manifest for correctness.
+ *
+ * @param manifest - Release manifest to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateRelease(manifest: ReleaseManifest): ReleaseValidationError[];
+/**
+ * Generate release notes markdown from a manifest and commit list.
+ */
+export declare function generateReleaseNotes(manifest: ReleaseManifest, commits: CommitInfo[]): string;
+/**
+ * Get the release checklist with default items.
+ * Each item's check function can be evaluated to determine pass/fail.
+ */
+export declare function getReleaseChecklist(manifest?: ReleaseManifest): ReleaseChecklistItem[];
+//# sourceMappingURL=release.d.ts.map

package/dist/build/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/build/release.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,uBAAuB;AACvB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,sBAAsB;IACtB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB;IACrB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAClC;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAYpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,eAAe,CAmBjB;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,sBAAsB,EAAE,CA2EnF;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,UAAU,EAAE,GACpB,MAAM,CAqER;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,oBAAoB,EAAE,CAyEtF"}

package/dist/build/release.js

@@ -0,0 +1,295 @@
+/**
+ * M6-13: Release candidate build & validation
+ * Handles release manifest creation, validation, and release notes generation.
+ *
+ * @module build/release
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { parseConventionalCommit } from './versioning.js';
+// ============================================================================
+// Release creation
+// ============================================================================
+/**
+ * Compute the SHA-256 hash of a buffer or string.
+ */
+export function computeSha256(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+/**
+ * Build a ReleaseArtifact from a file path.
+ * Returns null if the file does not exist.
+ */
+export function buildArtifact(name, filePath) {
+    if (!existsSync(filePath))
+        return null;
+    const content = readFileSync(filePath);
+    const stat = statSync(filePath);
+    return {
+        name,
+        path: filePath,
+        size: stat.size,
+        sha256: computeSha256(content),
+    };
+}
+/**
+ * Create a release manifest from a ReleaseConfig.
+ *
+ * @param config - Release configuration
+ * @param artifactPaths - Optional map of artifact name → file path
+ * @returns Release manifest
+ */
+export function createRelease(config, artifactPaths) {
+    const artifacts = [];
+    if (artifactPaths) {
+        for (const [name, filePath] of Object.entries(artifactPaths)) {
+            const artifact = buildArtifact(name, filePath);
+            if (artifact) {
+                artifacts.push(artifact);
+            }
+        }
+    }
+    return {
+        version: config.version,
+        channel: config.channel,
+        artifacts,
+        timestamp: new Date().toISOString(),
+        changelog: '',
+    };
+}
+// ============================================================================
+// Validation
+// ============================================================================
+const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[a-zA-Z0-9]+(?:\.[a-zA-Z0-9]+)*)?$/;
+/**
+ * Validate a release manifest for correctness.
+ *
+ * @param manifest - Release manifest to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+export function validateRelease(manifest) {
+    const errors = [];
+    // Version
+    if (!manifest.version) {
+        errors.push({ field: 'version', message: 'Version is required', severity: 'error' });
+    }
+    else if (!SEMVER_RE.test(manifest.version)) {
+        errors.push({ field: 'version', message: `Invalid semver version: ${manifest.version}`, severity: 'error' });
+    }
+    // Channel
+    const validChannels = ['stable', 'rc', 'beta', 'alpha'];
+    if (!manifest.channel) {
+        errors.push({ field: 'channel', message: 'Channel is required', severity: 'error' });
+    }
+    else if (!validChannels.includes(manifest.channel)) {
+        errors.push({ field: 'channel', message: `Invalid channel: ${manifest.channel}`, severity: 'error' });
+    }
+    // Channel / version consistency
+    if (manifest.channel === 'stable' && manifest.version.includes('-')) {
+        errors.push({
+            field: 'version',
+            message: 'Stable releases must not have prerelease suffixes',
+            severity: 'error',
+        });
+    }
+    if (manifest.channel !== 'stable' && !manifest.version.includes('-')) {
+        errors.push({
+            field: 'version',
+            message: `Non-stable channel "${manifest.channel}" should have a prerelease suffix`,
+            severity: 'warning',
+        });
+    }
+    // Timestamp
+    if (!manifest.timestamp) {
+        errors.push({ field: 'timestamp', message: 'Timestamp is required', severity: 'error' });
+    }
+    else if (isNaN(Date.parse(manifest.timestamp))) {
+        errors.push({ field: 'timestamp', message: 'Timestamp is not a valid ISO date', severity: 'error' });
+    }
+    // Artifacts
+    if (!Array.isArray(manifest.artifacts)) {
+        errors.push({ field: 'artifacts', message: 'Artifacts must be an array', severity: 'error' });
+    }
+    else {
+        for (let i = 0; i < manifest.artifacts.length; i++) {
+            const a = manifest.artifacts[i];
+            if (!a.name) {
+                errors.push({ field: `artifacts[${i}].name`, message: 'Artifact name is required', severity: 'error' });
+            }
+            if (!a.path) {
+                errors.push({ field: `artifacts[${i}].path`, message: 'Artifact path is required', severity: 'error' });
+            }
+            if (typeof a.size !== 'number' || a.size < 0) {
+                errors.push({ field: `artifacts[${i}].size`, message: 'Artifact size must be a non-negative number', severity: 'error' });
+            }
+            if (!a.sha256 || !/^[a-f0-9]{64}$/.test(a.sha256)) {
+                errors.push({ field: `artifacts[${i}].sha256`, message: 'Artifact sha256 must be a valid 64-char hex string', severity: 'error' });
+            }
+        }
+        // Duplicate names
+        const names = manifest.artifacts.map((a) => a.name);
+        const dupes = names.filter((n, i) => names.indexOf(n) !== i);
+        if (dupes.length > 0) {
+            errors.push({ field: 'artifacts', message: `Duplicate artifact names: ${[...new Set(dupes)].join(', ')}`, severity: 'warning' });
+        }
+    }
+    // Changelog (warning only)
+    if (!manifest.changelog) {
+        errors.push({ field: 'changelog', message: 'Changelog is empty', severity: 'warning' });
+    }
+    return errors;
+}
+// ============================================================================
+// Release notes generation
+// ============================================================================
+/**
+ * Generate release notes markdown from a manifest and commit list.
+ */
+export function generateReleaseNotes(manifest, commits) {
+    const lines = [];
+    const date = manifest.timestamp ? manifest.timestamp.slice(0, 10) : new Date().toISOString().slice(0, 10);
+    lines.push(`# ${manifest.version} (${date})`);
+    lines.push('');
+    if (manifest.channel !== 'stable') {
+        lines.push(`> **${manifest.channel.toUpperCase()}** release — not recommended for production use.`);
+        lines.push('');
+    }
+    // Group commits by type
+    const groups = {};
+    const breaking = [];
+    for (const commit of commits) {
+        const parsed = parseConventionalCommit(commit.message);
+        if (parsed.breaking) {
+            breaking.push(`- ${parsed.description} (${commit.sha.slice(0, 7)})`);
+        }
+        const key = parsed.type;
+        if (!groups[key])
+            groups[key] = [];
+        groups[key].push({ description: parsed.description, sha: commit.sha });
+    }
+    if (breaking.length > 0) {
+        lines.push('## ⚠ Breaking Changes');
+        lines.push('');
+        lines.push(...breaking);
+        lines.push('');
+    }
+    const headings = {
+        feat: '## Features',
+        fix: '## Bug Fixes',
+        perf: '## Performance',
+        refactor: '## Refactoring',
+        docs: '## Documentation',
+        chore: '## Chores',
+        test: '## Tests',
+        ci: '## CI',
+    };
+    for (const [type, heading] of Object.entries(headings)) {
+        const items = groups[type];
+        if (!items || items.length === 0)
+            continue;
+        lines.push(heading);
+        lines.push('');
+        for (const item of items) {
+            lines.push(`- ${item.description} (${item.sha.slice(0, 7)})`);
+        }
+        lines.push('');
+    }
+    // Artifacts section
+    if (manifest.artifacts.length > 0) {
+        lines.push('## Artifacts');
+        lines.push('');
+        lines.push('| Name | Size | SHA-256 |');
+        lines.push('|------|------|---------|');
+        for (const a of manifest.artifacts) {
+            const sizeKb = (a.size / 1024).toFixed(1);
+            lines.push(`| ${a.name} | ${sizeKb} KB | \`${a.sha256.slice(0, 12)}…\` |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+// ============================================================================
+// Release checklist
+// ============================================================================
+/**
+ * Get the release checklist with default items.
+ * Each item's check function can be evaluated to determine pass/fail.
+ */
+export function getReleaseChecklist(manifest) {
+    const items = [
+        {
+            name: 'Version is valid semver',
+            check: () => manifest ? SEMVER_RE.test(manifest.version) : false,
+            required: true,
+            status: 'skip',
+        },
+        {
+            name: 'Channel is set',
+            check: () => manifest ? !!manifest.channel : false,
+            required: true,
+            status: 'skip',
+        },
+        {
+            name: 'Timestamp is present',
+            check: () => manifest ? !!manifest.timestamp && !isNaN(Date.parse(manifest.timestamp)) : false,
+            required: true,
+            status: 'skip',
+        },
+        {
+            name: 'At least one artifact',
+            check: () => manifest ? manifest.artifacts.length > 0 : false,
+            required: false,
+            status: 'skip',
+        },
+        {
+            name: 'Changelog is non-empty',
+            check: () => manifest ? !!manifest.changelog : false,
+            required: false,
+            status: 'skip',
+        },
+        {
+            name: 'All artifact hashes are valid',
+            check: () => {
+                if (!manifest)
+                    return false;
+                return manifest.artifacts.every((a) => /^[a-f0-9]{64}$/.test(a.sha256));
+            },
+            required: true,
+            status: 'skip',
+        },
+        {
+            name: 'No duplicate artifact names',
+            check: () => {
+                if (!manifest)
+                    return false;
+                const names = manifest.artifacts.map((a) => a.name);
+                return new Set(names).size === names.length;
+            },
+            required: true,
+            status: 'skip',
+        },
+        {
+            name: 'Version matches channel',
+            check: () => {
+                if (!manifest)
+                    return false;
+                if (manifest.channel === 'stable')
+                    return !manifest.version.includes('-');
+                return manifest.version.includes('-');
+            },
+            required: false,
+            status: 'skip',
+        },
+    ];
+    // Evaluate checks
+    for (const item of items) {
+        try {
+            item.status = item.check() ? 'pass' : 'fail';
+        }
+        catch {
+            item.status = 'fail';
+        }
+    }
+    return items;
+}
+//# sourceMappingURL=release.js.map

package/dist/build/release.js.map

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

package/dist/build/versioning.d.ts

@@ -0,0 +1,38 @@
+/**
+ * M4-10: Version stamping & CHANGELOG generation
+ * Conventional commits parsing, version bumping, and changelog output.
+ */
+export interface CommitInfo {
+    sha: string;
+    message: string;
+    author: string;
+    date: string;
+    type: string;
+}
+export interface ConventionalCommit {
+    type: string;
+    scope: string | null;
+    description: string;
+    breaking: boolean;
+}
+/**
+ * Parse a conventional commit message into structured parts.
+ */
+export declare function parseConventionalCommit(message: string): ConventionalCommit;
+/**
+ * Bump a semver version string by the given increment type.
+ */
+export declare function bumpVersion(current: string, type: 'major' | 'minor' | 'patch' | 'prerelease'): string;
+/**
+ * Stamp a version string into the specified file contents.
+ * Returns an array of { file, content } with the version replaced.
+ */
+export declare function stampVersion(version: string, files: string[]): {
+    file: string;
+    content: string;
+}[];
+/**
+ * Generate a CHANGELOG entry from a list of conventional commits.
+ */
+export declare function generateChangelog(commits: CommitInfo[], currentVersion: string): string;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/build/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/build/versioning.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAkB3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CA4BrG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKlG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAmDvF"}