@seanmars/tospec 0.4.2

package/dist/core/shared/tool-detection.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Tool Detection Utilities
+ *
+ * Shared utilities for detecting tool configurations and version status.
+ */
+/**
+ * Names of skill directories created by tospec init. Project-scope skills can't
+ * be nested, so they live flat and prefixed at
+ * `<tool.skillsDir>/skills/tospec-<workflow>/SKILL.md`.
+ */
+export declare const SKILL_NAMES: readonly ["tospec-explore", "tospec-propose", "tospec-issue", "tospec-update", "tospec-apply", "tospec-sync", "tospec-archive"];
+export type SkillName = (typeof SKILL_NAMES)[number];
+/**
+ * Canonical skill directory names tospec used to create but no longer does.
+ * Cleaned up on init/update so an upgrade leaves no orphan dirs behind in
+ * `.agents/skills/`. verify was folded into apply; sync remains a real skill.
+ */
+export declare const LEGACY_SKILL_DIRS: readonly ["tospec-verify"];
+/**
+ * IDs of command templates created by tospec init.
+ */
+export declare const COMMAND_IDS: readonly ["explore", "propose", "issue", "apply", "sync", "archive"];
+export type CommandId = (typeof COMMAND_IDS)[number];
+/**
+ * Status of skill configuration for a tool.
+ */
+export interface ToolSkillStatus {
+    /** Whether the tool has any skills configured */
+    configured: boolean;
+    /** Whether all skills are configured */
+    fullyConfigured: boolean;
+    /** Number of skills currently configured */
+    skillCount: number;
+}
+/**
+ * Version information for a tool's skills.
+ */
+export interface ToolVersionStatus {
+    /** The tool ID */
+    toolId: string;
+    /** The tool's display name */
+    toolName: string;
+    /** Whether the tool has any skills configured */
+    configured: boolean;
+    /** The generatedBy version found in the skill files, or null if not found */
+    generatedByVersion: string | null;
+    /** Whether the tool needs updating (version mismatch or missing) */
+    needsUpdate: boolean;
+}
+/**
+ * Removes any legacy skill directories (see LEGACY_SKILL_DIRS) from the given
+ * skills directory. Idempotent — safe to call when they don't exist. Used by
+ * init/update so upgrades leave no orphan verify/sync dirs behind.
+ */
+export declare function removeLegacySkillDirs(skillsDir: string): Promise<number>;
+/**
+ * Removes the intermediate grouped skill layouts from earlier builds so an
+ * upgrade lands cleanly at the current flat `<toolBaseDir>/skills/tospec-<workflow>/`
+ * location (project-scope skills can't be nested in a sub-folder). Removes:
+ *   1. the grouped layout `<toolBaseDir>/skills/tospec/<workflow>/`
+ *   2. the no-`skills/`-layer layout `<toolBaseDir>/tospec/<workflow>/`
+ * The current flat `skills/tospec-<workflow>/` dirs are left alone (they're
+ * refreshed by the link loop; a retired one like tospec-verify is handled by
+ * removeLegacySkillDirs).
+ */
+export declare function removeLegacyToolSkillLayout(toolBaseDir: string): Promise<number>;
+/**
+ * Gets the list of tools with skillsDir configured.
+ */
+export declare function getToolsWithSkillsDir(): string[];
+/**
+ * Checks which skill files exist for a tool.
+ */
+export declare function getToolSkillStatus(projectRoot: string, toolId: string): ToolSkillStatus;
+/**
+ * Gets the skill status for all tools with skillsDir configured.
+ */
+export declare function getToolStates(projectRoot: string): Map<string, ToolSkillStatus>;
+/**
+ * Extracts the generatedBy version from a skill file's YAML frontmatter.
+ * Returns null if the field is not found or the file doesn't exist.
+ */
+export declare function extractGeneratedByVersion(skillFilePath: string): string | null;
+/**
+ * Gets version status for a tool by reading the first available skill file.
+ */
+export declare function getToolVersionStatus(projectRoot: string, toolId: string, currentVersion: string): ToolVersionStatus;
+/**
+ * Gets all configured tools in the project.
+ */
+export declare function getConfiguredTools(projectRoot: string): string[];
+/**
+ * Gets version status for all configured tools.
+ */
+export declare function getAllToolVersionStatus(projectRoot: string, currentVersion: string): ToolVersionStatus[];
+//# sourceMappingURL=tool-detection.d.ts.map

package/dist/core/shared/tool-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-detection.d.ts","sourceRoot":"","sources":["../../../src/core/shared/tool-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;GAIG;AACH,eAAO,MAAM,WAAW,iIAQd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,4BAA6B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,WAAW,sEAOd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAqBvF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAS/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAkCnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAIhE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,iBAAiB,EAAE,CAKrB"}

package/dist/core/shared/tool-detection.js

@@ -0,0 +1,207 @@
+/**
+ * Tool Detection Utilities
+ *
+ * Shared utilities for detecting tool configurations and version status.
+ */
+import path from 'path';
+import * as fs from 'fs';
+import { AI_TOOLS } from '../config.js';
+/**
+ * Names of skill directories created by tospec init. Project-scope skills can't
+ * be nested, so they live flat and prefixed at
+ * `<tool.skillsDir>/skills/tospec-<workflow>/SKILL.md`.
+ */
+export const SKILL_NAMES = [
+    'tospec-explore',
+    'tospec-propose',
+    'tospec-issue',
+    'tospec-update',
+    'tospec-apply',
+    'tospec-sync',
+    'tospec-archive',
+];
+/**
+ * Canonical skill directory names tospec used to create but no longer does.
+ * Cleaned up on init/update so an upgrade leaves no orphan dirs behind in
+ * `.agents/skills/`. verify was folded into apply; sync remains a real skill.
+ */
+export const LEGACY_SKILL_DIRS = ['tospec-verify'];
+/**
+ * IDs of command templates created by tospec init.
+ */
+export const COMMAND_IDS = [
+    'explore',
+    'propose',
+    'issue',
+    'apply',
+    'sync',
+    'archive',
+];
+/**
+ * Removes any legacy skill directories (see LEGACY_SKILL_DIRS) from the given
+ * skills directory. Idempotent — safe to call when they don't exist. Used by
+ * init/update so upgrades leave no orphan verify/sync dirs behind.
+ */
+export async function removeLegacySkillDirs(skillsDir) {
+    let removed = 0;
+    for (const dirName of LEGACY_SKILL_DIRS) {
+        const dir = path.join(skillsDir, dirName);
+        try {
+            if (fs.existsSync(dir)) {
+                await fs.promises.rm(dir, { recursive: true, force: true });
+                removed++;
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    return removed;
+}
+/**
+ * Removes the intermediate grouped skill layouts from earlier builds so an
+ * upgrade lands cleanly at the current flat `<toolBaseDir>/skills/tospec-<workflow>/`
+ * location (project-scope skills can't be nested in a sub-folder). Removes:
+ *   1. the grouped layout `<toolBaseDir>/skills/tospec/<workflow>/`
+ *   2. the no-`skills/`-layer layout `<toolBaseDir>/tospec/<workflow>/`
+ * The current flat `skills/tospec-<workflow>/` dirs are left alone (they're
+ * refreshed by the link loop; a retired one like tospec-verify is handled by
+ * removeLegacySkillDirs).
+ */
+export async function removeLegacyToolSkillLayout(toolBaseDir) {
+    let removed = 0;
+    const legacyDirs = [
+        path.join(toolBaseDir, 'skills', 'tospec'), // grouped: <tool>/skills/tospec/<workflow>
+        path.join(toolBaseDir, 'tospec'), // bare:    <tool>/tospec/<workflow>
+    ];
+    for (const dir of legacyDirs) {
+        try {
+            if (fs.existsSync(dir)) {
+                await fs.promises.rm(dir, { recursive: true, force: true });
+                removed++;
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    return removed;
+}
+/**
+ * Gets the list of tools with skillsDir configured.
+ */
+export function getToolsWithSkillsDir() {
+    return AI_TOOLS.filter((t) => t.skillsDir).map((t) => t.value);
+}
+/**
+ * Checks which skill files exist for a tool.
+ */
+export function getToolSkillStatus(projectRoot, toolId) {
+    const tool = AI_TOOLS.find((t) => t.value === toolId);
+    if (!tool?.skillsDir) {
+        return { configured: false, fullyConfigured: false, skillCount: 0 };
+    }
+    const skillsDir = path.join(projectRoot, tool.skillsDir, 'skills');
+    let skillCount = 0;
+    for (const skillName of SKILL_NAMES) {
+        const skillFile = path.join(skillsDir, skillName, 'SKILL.md');
+        if (fs.existsSync(skillFile)) {
+            skillCount++;
+        }
+    }
+    return {
+        configured: skillCount > 0,
+        fullyConfigured: skillCount === SKILL_NAMES.length,
+        skillCount,
+    };
+}
+/**
+ * Gets the skill status for all tools with skillsDir configured.
+ */
+export function getToolStates(projectRoot) {
+    const states = new Map();
+    const toolIds = AI_TOOLS.filter((t) => t.skillsDir).map((t) => t.value);
+    for (const toolId of toolIds) {
+        states.set(toolId, getToolSkillStatus(projectRoot, toolId));
+    }
+    return states;
+}
+/**
+ * Extracts the generatedBy version from a skill file's YAML frontmatter.
+ * Returns null if the field is not found or the file doesn't exist.
+ */
+export function extractGeneratedByVersion(skillFilePath) {
+    try {
+        if (!fs.existsSync(skillFilePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(skillFilePath, 'utf-8');
+        // Look for generatedBy in the YAML frontmatter
+        // The file format is:
+        // ---
+        // ...
+        // metadata:
+        //   author: tospec
+        //   version: "1.0"
+        //   generatedBy: "0.23.0"
+        // ---
+        const generatedByMatch = content.match(/^\s*generatedBy:\s*["']?([^"'\n]+)["']?\s*$/m);
+        if (generatedByMatch && generatedByMatch[1]) {
+            return generatedByMatch[1].trim();
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Gets version status for a tool by reading the first available skill file.
+ */
+export function getToolVersionStatus(projectRoot, toolId, currentVersion) {
+    const tool = AI_TOOLS.find((t) => t.value === toolId);
+    if (!tool?.skillsDir) {
+        return {
+            toolId,
+            toolName: toolId,
+            configured: false,
+            generatedByVersion: null,
+            needsUpdate: false,
+        };
+    }
+    const skillsDir = path.join(projectRoot, tool.skillsDir, 'skills');
+    let generatedByVersion = null;
+    // Find the first skill file that exists and read its version
+    for (const skillName of SKILL_NAMES) {
+        const skillFile = path.join(skillsDir, skillName, 'SKILL.md');
+        if (fs.existsSync(skillFile)) {
+            generatedByVersion = extractGeneratedByVersion(skillFile);
+            break;
+        }
+    }
+    const configured = getToolSkillStatus(projectRoot, toolId).configured;
+    const needsUpdate = configured && (generatedByVersion === null || generatedByVersion !== currentVersion);
+    return {
+        toolId,
+        toolName: tool.name,
+        configured,
+        generatedByVersion,
+        needsUpdate,
+    };
+}
+/**
+ * Gets all configured tools in the project.
+ */
+export function getConfiguredTools(projectRoot) {
+    return AI_TOOLS
+        .filter((t) => t.skillsDir && getToolSkillStatus(projectRoot, t.value).configured)
+        .map((t) => t.value);
+}
+/**
+ * Gets version status for all configured tools.
+ */
+export function getAllToolVersionStatus(projectRoot, currentVersion) {
+    const configuredTools = getConfiguredTools(projectRoot);
+    return configuredTools.map((toolId) => getToolVersionStatus(projectRoot, toolId, currentVersion));
+}
+//# sourceMappingURL=tool-detection.js.map

package/dist/core/shared/tool-detection.js.map

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

package/dist/core/spec-presenter.d.ts

@@ -0,0 +1,17 @@
+import type { RootOutput } from './root-selection.js';
+interface ShowOptions {
+    json?: boolean;
+    requirements?: boolean;
+    scenarios?: boolean;
+    requirement?: string;
+    noInteractive?: boolean;
+    rootOutput?: RootOutput;
+}
+export declare class SpecPresenter {
+    private specsDir;
+    private rootPath?;
+    constructor(rootPath?: string);
+    show(specId?: string, options?: ShowOptions): Promise<void>;
+}
+export {};
+//# sourceMappingURL=spec-presenter.d.ts.map

package/dist/core/spec-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-presenter.d.ts","sourceRoot":"","sources":["../../src/core/spec-presenter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAgDD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAId,QAAQ,CAAC,EAAE,MAAM;IAKvB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2CtE"}

package/dist/core/spec-presenter.js

@@ -0,0 +1,98 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { MarkdownParser } from './parsers/markdown-parser.js';
+import { isInteractive } from '../utils/interactive.js';
+import { getSpecIds } from '../utils/item-discovery.js';
+const SPECS_DIR = 'tospec/specs';
+function parseSpecFromFile(specPath, specId) {
+    const content = readFileSync(specPath, 'utf-8');
+    const parser = new MarkdownParser(content);
+    return parser.parseSpec(specId);
+}
+function validateRequirementIndex(spec, requirementOpt) {
+    if (!requirementOpt)
+        return undefined;
+    const index = Number.parseInt(requirementOpt, 10);
+    if (!Number.isInteger(index) || index < 1 || index > spec.requirements.length) {
+        throw new Error(`Requirement ${requirementOpt} not found`);
+    }
+    return index - 1; // convert to 0-based
+}
+function filterSpec(spec, options) {
+    const requirementIndex = validateRequirementIndex(spec, options.requirement);
+    const includeScenarios = options.scenarios !== false && !options.requirements;
+    const filteredRequirements = (requirementIndex !== undefined
+        ? [spec.requirements[requirementIndex]]
+        : spec.requirements).map(req => ({
+        text: req.text,
+        scenarios: includeScenarios ? req.scenarios : [],
+    }));
+    const metadata = spec.metadata ?? { version: '1.0.0', format: 'tospec' };
+    return {
+        name: spec.name,
+        overview: spec.overview,
+        requirements: filteredRequirements,
+        metadata,
+    };
+}
+/**
+ * Print the raw markdown content for a spec file without any formatting.
+ * Raw-first behavior ensures text mode is a passthrough for deterministic output.
+ */
+function printSpecTextRaw(specPath) {
+    const content = readFileSync(specPath, 'utf-8');
+    console.log(content);
+}
+export class SpecPresenter {
+    specsDir;
+    rootPath;
+    // rootPath is set only by root-aware callers (top-level `show`); the
+    // deprecated noun-form commands stay cwd-based.
+    constructor(rootPath) {
+        this.rootPath = rootPath;
+        this.specsDir = rootPath ? join(rootPath, 'tospec', 'specs') : SPECS_DIR;
+    }
+    async show(specId, options = {}) {
+        if (!specId) {
+            const canPrompt = isInteractive(options);
+            const specIds = await getSpecIds(this.rootPath ?? process.cwd());
+            if (canPrompt && specIds.length > 0) {
+                const { select } = await import('@inquirer/prompts');
+                specId = await select({
+                    message: 'Select a spec to show',
+                    choices: specIds.map(id => ({ name: id, value: id })),
+                });
+            }
+            else {
+                throw new Error('Missing required argument <spec-id>');
+            }
+        }
+        const specPath = join(this.specsDir, specId, 'spec.md');
+        if (!existsSync(specPath)) {
+            // Root-aware callers get the absolute path; the cwd-based noun form
+            // keeps its historical forward-slash relative message on all platforms.
+            const displayPath = this.rootPath ? specPath : `tospec/specs/${specId}/spec.md`;
+            throw new Error(`Spec '${specId}' not found at ${displayPath}`);
+        }
+        if (options.json) {
+            if (options.requirements && options.requirement) {
+                throw new Error('Options --requirements and --requirement cannot be used together');
+            }
+            const parsed = parseSpecFromFile(specPath, specId);
+            const filtered = filterSpec(parsed, options);
+            const output = {
+                id: specId,
+                title: parsed.name,
+                overview: parsed.overview,
+                requirementCount: filtered.requirements.length,
+                requirements: filtered.requirements,
+                metadata: parsed.metadata ?? { version: '1.0.0', format: 'tospec' },
+                ...(options.rootOutput ? { root: options.rootOutput } : {}),
+            };
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        printSpecTextRaw(specPath);
+    }
+}
+//# sourceMappingURL=spec-presenter.js.map

package/dist/core/spec-presenter.js.map

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

package/dist/core/specs-apply.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Spec Application Logic
+ *
+ * Extracted from ArchiveCommand to enable standalone spec application.
+ * Applies delta specs from a change to main specs without archiving.
+ */
+export interface SpecUpdate {
+    source: string;
+    target: string;
+    exists: boolean;
+}
+export interface ApplyResult {
+    capability: string;
+    added: number;
+    modified: number;
+    removed: number;
+    renamed: number;
+}
+export interface SpecsApplyOutput {
+    changeName: string;
+    capabilities: ApplyResult[];
+    totals: {
+        added: number;
+        modified: number;
+        removed: number;
+        renamed: number;
+    };
+    noChanges: boolean;
+}
+/**
+ * Find all delta spec files that need to be applied from a change.
+ */
+export declare function findSpecUpdates(changeDir: string, mainSpecsDir: string): Promise<SpecUpdate[]>;
+/**
+ * Build an updated spec by applying delta operations.
+ * Returns the rebuilt content and counts of operations.
+ */
+export declare function buildUpdatedSpec(update: SpecUpdate, changeName: string, options?: {
+    silent?: boolean;
+}): Promise<{
+    rebuilt: string;
+    counts: {
+        added: number;
+        modified: number;
+        removed: number;
+        renamed: number;
+    };
+}>;
+/**
+ * Write an updated spec to disk.
+ */
+export declare function writeUpdatedSpec(update: SpecUpdate, rebuilt: string, counts: {
+    added: number;
+    modified: number;
+    removed: number;
+    renamed: number;
+}, options?: {
+    silent?: boolean;
+    displayPath?: string;
+}): Promise<void>;
+/**
+ * Build a skeleton spec for new capabilities.
+ */
+export declare function buildSpecSkeleton(specFolderName: string, changeName: string): string;
+/**
+ * Apply all delta specs from a change to main specs.
+ *
+ * @param projectRoot - The project root directory
+ * @param changeName - The name of the change to apply
+ * @param options - Options for the operation
+ * @returns Result of the operation with counts
+ */
+export declare function applySpecs(projectRoot: string, changeName: string, options?: {
+    dryRun?: boolean;
+    skipValidation?: boolean;
+    silent?: boolean;
+}): Promise<SpecsApplyOutput>;
+//# sourceMappingURL=specs-apply.d.ts.map

package/dist/core/specs-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs-apply.d.ts","sourceRoot":"","sources":["../../src/core/specs-apply.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE,OAAO,CAAC;CACpB;AAWD;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAuCpG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CA0P7G;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC7E,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGpF;AAqCD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,OAAO,CAAC,gBAAgB,CAAC,CAmG3B"}