loadouts 0.1.11

package/dist/core/import-discovery.js

@@ -0,0 +1,304 @@
+/**
+ * Import Discovery — scan tool directories for existing configurations
+ * that can be imported into loadout.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileExists, isDirectory, isSymlink, listFiles, listFilesWithExtension } from "../lib/fs.js";
+const TOOL_LOCATIONS = {
+    "claude-code": {
+        rules: { dir: ".claude/rules", ext: ".md" },
+        skills: { dir: ".claude/skills" },
+    },
+    cursor: {
+        rules: { dir: ".cursor/rules", ext: ".mdc" },
+        skills: { dir: ".cursor/skills" },
+    },
+    opencode: {
+        rules: { dir: ".opencode/rules", ext: ".md" },
+        skills: { dir: ".opencode/skills" },
+    },
+    codex: {
+        // codex doesn't support rules
+        skills: { dir: ".agents/skills" },
+    },
+    pi: {
+        // pi doesn't have native rules support
+        skills: { dir: ".pi/skills" },
+    },
+};
+// Instruction file locations to check (in priority order)
+const INSTRUCTION_FILES = ["AGENTS.md", "CLAUDE.md"];
+// ---------------------------------------------------------------------------
+// Discovery functions
+// ---------------------------------------------------------------------------
+/**
+ * Get file/directory size.
+ */
+function getSize(filePath) {
+    const stat = fs.statSync(filePath);
+    if (stat.isDirectory()) {
+        let total = 0;
+        const entries = fs.readdirSync(filePath, { withFileTypes: true });
+        for (const entry of entries) {
+            total += getSize(path.join(filePath, entry.name));
+        }
+        return total;
+    }
+    return stat.size;
+}
+/**
+ * Get modification time.
+ */
+function getMtime(filePath) {
+    return fs.statSync(filePath).mtime;
+}
+/**
+ * Discover rules in a tool directory.
+ */
+function discoverRules(projectRoot, tool, locations) {
+    if (!locations.rules)
+        return [];
+    const rulesDir = path.join(projectRoot, locations.rules.dir);
+    if (!isDirectory(rulesDir))
+        return [];
+    const artifacts = [];
+    const files = listFilesWithExtension(rulesDir, locations.rules.ext);
+    for (const file of files) {
+        const sourcePath = path.join(rulesDir, file);
+        const name = file.replace(/\.(md|mdc)$/, "");
+        artifacts.push({
+            kind: "rule",
+            name,
+            sourcePath,
+            displayPath: path.join(locations.rules.dir, file),
+            tool,
+            size: getSize(sourcePath),
+            mtime: getMtime(sourcePath),
+            destPath: `rules/${name}.md`,
+        });
+    }
+    return artifacts;
+}
+/**
+ * Discover skills in a tool directory.
+ * Skips symlinked directories that point to other tool directories
+ * to avoid duplicate detection.
+ */
+function discoverSkills(projectRoot, tool, locations) {
+    if (!locations.skills)
+        return [];
+    const skillsDir = path.join(projectRoot, locations.skills.dir);
+    if (!isDirectory(skillsDir))
+        return [];
+    // Skip if this skills dir is a symlink pointing to another tool's directory
+    // (e.g., .cursor/skills -> ../.claude/skills)
+    if (isSymlink(skillsDir)) {
+        try {
+            const target = fs.realpathSync(skillsDir);
+            // Check if target is inside another tool's directory
+            for (const [otherTool, otherLoc] of Object.entries(TOOL_LOCATIONS)) {
+                if (otherTool === tool || !otherLoc.skills)
+                    continue;
+                const otherSkillsDir = path.join(projectRoot, otherLoc.skills.dir);
+                if (target.startsWith(fs.realpathSync(path.dirname(otherSkillsDir)))) {
+                    // This is a symlink to another tool's skills - skip to avoid duplicates
+                    return [];
+                }
+            }
+        }
+        catch {
+            // If we can't resolve the symlink, proceed normally
+        }
+    }
+    const artifacts = [];
+    const entries = listFiles(skillsDir);
+    for (const entry of entries) {
+        const skillPath = path.join(skillsDir, entry);
+        if (!isDirectory(skillPath))
+            continue;
+        // Check for SKILL.md to confirm it's a valid skill
+        const skillMdPath = path.join(skillPath, "SKILL.md");
+        if (!fileExists(skillMdPath))
+            continue;
+        artifacts.push({
+            kind: "skill",
+            name: entry,
+            sourcePath: skillPath,
+            displayPath: path.join(locations.skills.dir, entry),
+            tool,
+            size: getSize(skillPath),
+            mtime: getMtime(skillPath),
+            destPath: `skills/${entry}`,
+        });
+    }
+    return artifacts;
+}
+/**
+ * Check if a file at project root is managed by loadout.
+ * A file is managed if it's a symlink pointing into .loadouts/.
+ */
+function isManagedByLoadout(filePath, loadoutPath) {
+    if (!loadoutPath)
+        return false;
+    if (!isSymlink(filePath))
+        return false;
+    try {
+        const target = fs.readlinkSync(filePath);
+        const absoluteTarget = path.isAbsolute(target)
+            ? target
+            : path.resolve(path.dirname(filePath), target);
+        return absoluteTarget.startsWith(loadoutPath);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a file is the auto-generated CLAUDE.md wrapper.
+ */
+function isClaudeWrapper(filePath) {
+    if (!fileExists(filePath))
+        return false;
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return content.includes("auto-generated by Loadout") || content.includes("auto-generated by Loadouts");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Discover instruction files at project root.
+ * Only discovers files that are NOT managed by loadout.
+ */
+function discoverInstructions(projectRoot, loadoutPath) {
+    const artifacts = [];
+    for (const filename of INSTRUCTION_FILES) {
+        const filePath = path.join(projectRoot, filename);
+        if (!fileExists(filePath))
+            continue;
+        // Skip if this file is managed by loadout (symlink to .loadouts/)
+        if (isManagedByLoadout(filePath, loadoutPath))
+            continue;
+        // Skip auto-generated CLAUDE.md wrapper
+        if (filename === "CLAUDE.md" && isClaudeWrapper(filePath))
+            continue;
+        artifacts.push({
+            kind: "instruction",
+            name: "AGENTS.md",
+            sourcePath: filePath,
+            displayPath: filename,
+            tool: "project-root",
+            size: getSize(filePath),
+            mtime: getMtime(filePath),
+            destPath: "instructions/AGENTS.base.md", // Will be updated by install based on target loadout
+        });
+    }
+    return artifacts;
+}
+/**
+ * Check if an artifact already exists in .loadouts/.
+ * For instructions, we DON'T filter them out since unmanaged files at project root
+ * should be offered for import (to replace the template).
+ */
+function artifactExistsInLoadout(loadoutPath, artifact) {
+    // Instructions at project root are already filtered by discoverInstructions
+    // if they're managed. If they reach here, they're unmanaged and should be imported.
+    if (artifact.kind === "instruction") {
+        return false; // Always offer to import unmanaged instruction files
+    }
+    const destPath = path.join(loadoutPath, artifact.destPath);
+    return artifact.kind === "skill" ? isDirectory(destPath) : fileExists(destPath);
+}
+/**
+ * Discover all importable artifacts in a project.
+ */
+export function discoverImportableArtifacts(projectRoot, options = {}) {
+    const artifacts = [];
+    const warnings = [];
+    const { tools, kinds, loadoutPath } = options;
+    // Filter tools if specified
+    const toolsToScan = tools
+        ? Object.keys(TOOL_LOCATIONS).filter((t) => tools.includes(t))
+        : Object.keys(TOOL_LOCATIONS);
+    // Discover from each tool directory
+    for (const tool of toolsToScan) {
+        const locations = TOOL_LOCATIONS[tool];
+        // Rules
+        if (!kinds || kinds.includes("rule")) {
+            artifacts.push(...discoverRules(projectRoot, tool, locations));
+        }
+        // Skills
+        if (!kinds || kinds.includes("skill")) {
+            artifacts.push(...discoverSkills(projectRoot, tool, locations));
+        }
+    }
+    // Instructions (not tool-specific)
+    if (!kinds || kinds.includes("instruction")) {
+        artifacts.push(...discoverInstructions(projectRoot, loadoutPath));
+    }
+    // Filter out artifacts that already exist in .loadouts/
+    const filteredArtifacts = loadoutPath
+        ? artifacts.filter((a) => !artifactExistsInLoadout(loadoutPath, a))
+        : artifacts;
+    // Detect conflicts (same name from different tools)
+    const byName = new Map();
+    for (const artifact of filteredArtifacts) {
+        const key = `${artifact.kind}:${artifact.name}`;
+        const existing = byName.get(key) || [];
+        existing.push(artifact);
+        byName.set(key, existing);
+    }
+    const conflicts = new Map();
+    for (const [key, items] of byName) {
+        if (items.length > 1) {
+            conflicts.set(key, items);
+        }
+    }
+    return { artifacts: filteredArtifacts, conflicts, warnings };
+}
+/**
+ * Group artifacts by kind for display.
+ */
+export function groupByKind(artifacts) {
+    const groups = {
+        instruction: [],
+        rule: [],
+        skill: [],
+    };
+    for (const artifact of artifacts) {
+        groups[artifact.kind].push(artifact);
+    }
+    return groups;
+}
+/**
+ * Format file size for display.
+ */
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * Format relative time for display.
+ */
+export function formatRelativeTime(date) {
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    if (diffDays === 0)
+        return "today";
+    if (diffDays === 1)
+        return "yesterday";
+    if (diffDays < 7)
+        return `${diffDays} days ago`;
+    if (diffDays < 30)
+        return `${Math.floor(diffDays / 7)} weeks ago`;
+    if (diffDays < 365)
+        return `${Math.floor(diffDays / 30)} months ago`;
+    return `${Math.floor(diffDays / 365)} years ago`;
+}
+//# sourceMappingURL=import-discovery.js.map

package/dist/core/import-discovery.js.map

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

package/dist/core/kindLoader.d.ts

@@ -0,0 +1,119 @@
+/**
+ * YAML kind loader — reads *.yaml / *.yml files from .loadouts/kinds/ directories
+ * and registers them as KindSpec entries in the registry.
+ *
+ * Declarative kind files let teams add new artifact types without writing code.
+ * See plans/EXTENSIBILITY.md §3a for the full format.
+ *
+ * Loading is idempotent: kind IDs already present in the registry are skipped
+ * with a warning (built-ins always take precedence over YAML definitions).
+ */
+import { z } from "zod";
+import { type KindSpec } from "./registry.js";
+import type { LoadoutRoot } from "./types.js";
+export declare const YamlKindSchema: z.ZodObject<{
+    /**
+     * Unique kind identifier. Convention: namespace with a dot (e.g. "myteam.prompt")
+     * to avoid collision with built-ins ("rule", "skill", "instruction") and other teams.
+     */
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    detect: z.ZodUnion<[z.ZodObject<{
+        pathPrefix: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        pathPrefix: string;
+    }, {
+        pathPrefix: string;
+    }>, z.ZodObject<{
+        pathExact: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        pathExact: string;
+    }, {
+        pathExact: string;
+    }>]>;
+    layout: z.ZodEnum<["file", "dir"]>;
+    targets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        path: z.ZodUnion<[z.ZodString, z.ZodObject<{
+            project: z.ZodString;
+            global: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            global: string;
+            project: string;
+        }, {
+            global: string;
+            project: string;
+        }>]>;
+        ext: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodEnum<["symlink", "copy"]>>;
+        transform: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string | {
+            global: string;
+            project: string;
+        };
+        mode?: "symlink" | "copy" | undefined;
+        ext?: string | undefined;
+        transform?: string | undefined;
+    }, {
+        path: string | {
+            global: string;
+            project: string;
+        };
+        mode?: "symlink" | "copy" | undefined;
+        ext?: string | undefined;
+        transform?: string | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    detect: {
+        pathPrefix: string;
+    } | {
+        pathExact: string;
+    };
+    layout: "file" | "dir";
+    targets?: Record<string, {
+        path: string | {
+            global: string;
+            project: string;
+        };
+        mode?: "symlink" | "copy" | undefined;
+        ext?: string | undefined;
+        transform?: string | undefined;
+    }> | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    detect: {
+        pathPrefix: string;
+    } | {
+        pathExact: string;
+    };
+    layout: "file" | "dir";
+    targets?: Record<string, {
+        path: string | {
+            global: string;
+            project: string;
+        };
+        mode?: "symlink" | "copy" | undefined;
+        ext?: string | undefined;
+        transform?: string | undefined;
+    }> | undefined;
+    description?: string | undefined;
+}>;
+export type YamlKindDefinition = z.infer<typeof YamlKindSchema>;
+/**
+ * Parse a YAML kind definition file into a KindSpec.
+ */
+export declare function parseYamlKind(filePath: string): KindSpec;
+/**
+ * Load all YAML kinds from the `kinds/` subdirectory of each discovered root
+ * and register them into the global registry.
+ *
+ * Already-registered IDs are skipped with a warning (built-ins win).
+ * Parse errors are reported but do not abort loading.
+ *
+ * This is called synchronously from `resolveLoadout` after root discovery,
+ * so YAML kinds are available for `inferKind()` during item resolution.
+ */
+export declare function loadYamlKindsFromRoots(roots: LoadoutRoot[]): void;
+//# sourceMappingURL=kindLoader.d.ts.map

package/dist/core/kindLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kindLoader.d.ts","sourceRoot":"","sources":["../../src/core/kindLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAY,KAAK,QAAQ,EAAyC,MAAM,eAAe,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuB9C,eAAO,MAAM,cAAc;IACzB;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMH,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMhE;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CA2BxD;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAyCjE"}

package/dist/core/kindLoader.js

@@ -0,0 +1,141 @@
+/**
+ * YAML kind loader — reads *.yaml / *.yml files from .loadouts/kinds/ directories
+ * and registers them as KindSpec entries in the registry.
+ *
+ * Declarative kind files let teams add new artifact types without writing code.
+ * See plans/EXTENSIBILITY.md §3a for the full format.
+ *
+ * Loading is idempotent: kind IDs already present in the registry are skipped
+ * with a warning (built-ins always take precedence over YAML definitions).
+ */
+import * as path from "node:path";
+import * as yaml from "yaml";
+import { z } from "zod";
+import { readFile, fileExists, isDirectory, listFiles } from "../lib/fs.js";
+import { registry } from "./registry.js";
+// ---------------------------------------------------------------------------
+// YAML schema
+// ---------------------------------------------------------------------------
+const YamlOutputMappingSchema = z.object({
+    path: z.union([
+        z.string(),
+        z.object({ project: z.string(), global: z.string() }),
+    ]),
+    ext: z.string().optional(),
+    // "generate" is code-only — YAML kinds cannot generate arbitrary content.
+    mode: z.enum(["symlink", "copy"]).optional(),
+    // Inline transforms require code; YAML kinds can only reference a named transform.
+    transform: z.string().optional(),
+});
+const YamlKindDetectSchema = z.union([
+    z.object({ pathPrefix: z.string() }),
+    z.object({ pathExact: z.string() }),
+]);
+export const YamlKindSchema = z.object({
+    /**
+     * Unique kind identifier. Convention: namespace with a dot (e.g. "myteam.prompt")
+     * to avoid collision with built-ins ("rule", "skill", "instruction") and other teams.
+     */
+    id: z.string().min(1),
+    description: z.string().optional(),
+    detect: YamlKindDetectSchema,
+    layout: z.enum(["file", "dir"]),
+    targets: z.record(z.string(), YamlOutputMappingSchema).optional(),
+});
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a YAML kind definition file into a KindSpec.
+ */
+export function parseYamlKind(filePath) {
+    const content = readFile(filePath);
+    const raw = yaml.parse(content);
+    const def = YamlKindSchema.parse(raw);
+    // Build detect predicate from the declarative spec
+    const detect = buildDetect(def.detect);
+    // Convert targets to OutputMappings
+    const defaultTargets = {};
+    for (const [toolName, target] of Object.entries(def.targets ?? {})) {
+        const mapping = {
+            path: target.path,
+        };
+        if (target.ext !== undefined)
+            mapping.ext = target.ext;
+        if (target.mode !== undefined)
+            mapping.mode = target.mode;
+        if (target.transform !== undefined)
+            mapping.transform = target.transform;
+        defaultTargets[toolName] = mapping;
+    }
+    return {
+        id: def.id,
+        description: def.description,
+        detect,
+        layout: def.layout,
+        defaultTargets,
+    };
+}
+function buildDetect(spec) {
+    if ("pathPrefix" in spec) {
+        const prefix = spec.pathPrefix;
+        return (rel) => rel.startsWith(prefix);
+    }
+    if ("pathExact" in spec) {
+        const exact = spec.pathExact;
+        return (rel) => rel === exact;
+    }
+    // TypeScript exhaustiveness guard
+    throw new Error("Invalid detect spec");
+}
+// ---------------------------------------------------------------------------
+// Loading
+// ---------------------------------------------------------------------------
+/**
+ * Load all YAML kinds from the `kinds/` subdirectory of each discovered root
+ * and register them into the global registry.
+ *
+ * Already-registered IDs are skipped with a warning (built-ins win).
+ * Parse errors are reported but do not abort loading.
+ *
+ * This is called synchronously from `resolveLoadout` after root discovery,
+ * so YAML kinds are available for `inferKind()` during item resolution.
+ */
+export function loadYamlKindsFromRoots(roots) {
+    for (const root of roots) {
+        const kindsDir = path.join(root.path, "kinds");
+        if (!isDirectory(kindsDir))
+            continue;
+        const files = listFiles(kindsDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
+        for (const file of files) {
+            const filePath = path.join(kindsDir, file);
+            if (!fileExists(filePath))
+                continue;
+            try {
+                const kind = parseYamlKind(filePath);
+                // Warn if ID looks like a built-in or has no namespace separator
+                if (!kind.id.includes(".")) {
+                    console.warn(`[loadout] Warning: custom kind "${kind.id}" in ${filePath} ` +
+                        `has no namespace (e.g. "myteam.${kind.id}"). ` +
+                        `Dot-namespaced IDs are recommended to avoid collisions with built-ins.`);
+                }
+                registry.registerKind(kind);
+            }
+            catch (err) {
+                if (err instanceof Error && err.message.includes("already registered")) {
+                    console.warn(`[loadout] Warning: kind from ${filePath} was skipped — ` +
+                        `"${extractId(err.message)}" is already registered (built-in takes precedence).`);
+                }
+                else {
+                    console.warn(`[loadout] Warning: could not load kind from ${filePath}: ` +
+                        (err instanceof Error ? err.message : String(err)));
+                }
+            }
+        }
+    }
+}
+function extractId(errMsg) {
+    const m = errMsg.match(/Kind "([^"]+)"/);
+    return m ? m[1] : "unknown";
+}
+//# sourceMappingURL=kindLoader.js.map

package/dist/core/kindLoader.js.map

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

package/dist/core/manifest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Ownership manifest and drift detection
+ */
+import type { AppliedState, ManifestEntry } from "./types.js";
+/**
+ * Load the applied state from disk.
+ * Handles migration from legacy single-loadout format to multi-loadout format.
+ */
+export declare function loadState(loadoutRoot: string): AppliedState | null;
+/**
+ * Save the applied state to disk.
+ */
+export declare function saveState(loadoutRoot: string, state: AppliedState): void;
+/**
+ * Clear the applied state.
+ */
+export declare function clearState(loadoutRoot: string): void;
+/**
+ * Check if a target path is owned by the manifest.
+ */
+export declare function isOwned(state: AppliedState | null, targetPath: string): boolean;
+/**
+ * Check if a target path exists and is NOT owned by the manifest.
+ * This is what we need to detect before overwriting.
+ */
+export declare function isUnmanagedCollision(state: AppliedState | null, targetPath: string, projectRoot: string): boolean;
+/**
+ * Detect drift in managed outputs.
+ */
+export interface DriftResult {
+    entry: ManifestEntry;
+    status: "ok" | "missing" | "modified" | "unlinked" | "broken" | "misdirected";
+}
+export declare function detectDrift(state: AppliedState, projectRoot: string): DriftResult[];
+/**
+ * Get all target paths that would be affected by applying new entries.
+ */
+export declare function getAffectedPaths(entries: ManifestEntry[]): Set<string>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAW1E;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA+DlE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAGxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG/E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAWT;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;CAC/E;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,WAAW,EAAE,CA0Df;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAEtE"}