dot-agents 0.4.1 → 0.6.0

package/dist/lib/processor.test.js

@@ -0,0 +1,134 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+// Inline hasPersonaFile logic for testing without module resolution issues
+// Mirrors the logic from persona.ts
+import { stat } from "node:fs/promises";
+// Get the directory of this file and derive the project root
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// src/lib/processor.test.ts -> project root is ../../
+const PROJECT_ROOT = join(__dirname, "..", "..");
+const PERSONA_FILENAME = "PERSONA.md";
+async function hasPersonaFile(dirPath) {
+    try {
+        const filePath = join(dirPath, PERSONA_FILENAME);
+        const stats = await stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+// Inline personaExists logic for testing
+// Mirrors the logic from processor.ts
+async function personaExists(config, channelName, personasList = []) {
+    const personaName = channelName.slice(1); // Remove @ prefix
+    // Check for root persona (.agents/PERSONA.md)
+    if (personaName === "root") {
+        return await hasPersonaFile(config.agentsDir);
+    }
+    // Check against provided persona list (simulating listPersonas)
+    for (const path of personasList) {
+        const parts = path.split("/");
+        const name = parts[parts.length - 1];
+        if (name === personaName) {
+            return true;
+        }
+    }
+    return false;
+}
+describe("personaExists", () => {
+    describe("root persona handling", () => {
+        it("returns true for @root when .agents/PERSONA.md exists", async () => {
+            // Use the actual dot-agents project as the test fixture
+            // This project has a root persona at .agents/PERSONA.md
+            const config = {
+                agentsDir: join(PROJECT_ROOT, ".agents"),
+                personasDir: join(PROJECT_ROOT, ".agents", "personas"),
+            };
+            const exists = await personaExists(config, "@root");
+            assert.strictEqual(exists, true, "Should find root persona when .agents/PERSONA.md exists");
+        });
+        it("returns false for @root when directory has no PERSONA.md", async () => {
+            // Use a directory that definitely won't have PERSONA.md
+            const config = {
+                agentsDir: "/tmp/nonexistent-agents-dir-test",
+                personasDir: "/tmp/nonexistent-agents-dir-test/personas",
+            };
+            const exists = await personaExists(config, "@root");
+            assert.strictEqual(exists, false, "Should return false when no root persona exists");
+        });
+    });
+    describe("named persona handling", () => {
+        it("returns true for @developer when developer persona exists in list", async () => {
+            const config = {
+                agentsDir: "/project/.agents",
+                personasDir: "/project/.agents/personas",
+            };
+            const personasList = [
+                "/project/.agents/personas/developer",
+                "/project/.agents/personas/reviewer",
+            ];
+            const exists = await personaExists(config, "@developer", personasList);
+            assert.strictEqual(exists, true);
+        });
+        it("returns false for @unknown when persona not in list", async () => {
+            const config = {
+                agentsDir: "/project/.agents",
+                personasDir: "/project/.agents/personas",
+            };
+            const personasList = [
+                "/project/.agents/personas/developer",
+                "/project/.agents/personas/reviewer",
+            ];
+            const exists = await personaExists(config, "@unknown", personasList);
+            assert.strictEqual(exists, false);
+        });
+        it("handles nested persona paths correctly", async () => {
+            const config = {
+                agentsDir: "/project/.agents",
+                personasDir: "/project/.agents/personas",
+            };
+            // Nested persona: claude/developer
+            const personasList = [
+                "/project/.agents/personas/claude/developer",
+            ];
+            // The last segment of the path is "developer"
+            const exists = await personaExists(config, "@developer", personasList);
+            assert.strictEqual(exists, true);
+        });
+        it("root check does not use personas list", async () => {
+            const config = {
+                agentsDir: "/tmp/nonexistent-test-dir",
+                personasDir: "/tmp/nonexistent-test-dir/personas",
+            };
+            // Even if "root" is in the personas list, @root should check agentsDir
+            const personasList = [
+                "/some/path/root", // This should NOT match @root
+            ];
+            const exists = await personaExists(config, "@root", personasList);
+            // Should be false because it checks hasPersonaFile(agentsDir), not the list
+            assert.strictEqual(exists, false);
+        });
+    });
+});
+describe("hasPersonaFile", () => {
+    it("returns true when PERSONA.md exists", async () => {
+        // Use the actual .agents directory which has PERSONA.md
+        const agentsDir = join(PROJECT_ROOT, ".agents");
+        const exists = await hasPersonaFile(agentsDir);
+        assert.strictEqual(exists, true);
+    });
+    it("returns false when directory does not exist", async () => {
+        const exists = await hasPersonaFile("/nonexistent/path");
+        assert.strictEqual(exists, false);
+    });
+    it("returns false when directory exists but has no PERSONA.md", async () => {
+        // Use /tmp which exists but won't have PERSONA.md
+        const exists = await hasPersonaFile("/tmp");
+        assert.strictEqual(exists, false);
+    });
+});
+//# sourceMappingURL=processor.test.js.map

package/dist/lib/processor.test.js.map

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

package/dist/lib/registry.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Project registry structure
+ */
+export interface ProjectRegistry {
+    projects: Record<string, string>;
+}
+/**
+ * Parsed cross-project channel address
+ */
+export interface CrossProjectAddress {
+    /** Project name from registry (null if local) */
+    project: string | null;
+    /** Channel type: # for public, @ for DM */
+    type: "#" | "@";
+    /** Channel or persona name */
+    name: string;
+    /** Full original address for display */
+    original: string;
+}
+/**
+ * Get path to the projects registry file
+ */
+export declare function getRegistryPath(): string;
+/**
+ * Load the project registry
+ */
+export declare function loadRegistry(): Promise<ProjectRegistry>;
+/**
+ * Save the project registry
+ */
+export declare function saveRegistry(registry: ProjectRegistry): Promise<void>;
+/**
+ * Register a project in the registry
+ */
+export declare function registerProject(name: string, path: string): Promise<void>;
+/**
+ * Unregister a project from the registry
+ */
+export declare function unregisterProject(name: string): Promise<boolean>;
+/**
+ * Resolve a project name to its .agents path
+ */
+export declare function resolveProject(name: string): Promise<string | null>;
+/**
+ * Parse a channel address that may include a project prefix
+ *
+ * Formats:
+ * - @persona (local DM)
+ * - #channel (local public channel)
+ * - @project/persona (cross-project DM)
+ * - #project/channel (cross-project public channel)
+ */
+export declare function parseChannelAddress(address: string): CrossProjectAddress;
+/**
+ * Result of resolving a channel address
+ */
+export interface ResolvedChannelAddress {
+    /** Path to the channels directory (local or remote) */
+    channelsDir: string;
+    /** Channel name within that directory (e.g., @persona, #channel, @root) */
+    localChannelName: string;
+    /** True if this resolved to a project's entry point */
+    isProjectEntryPoint?: boolean;
+    /** The project name if routed to a project */
+    projectName?: string;
+}
+/**
+ * Resolve a channel address to a channels directory and local channel name
+ *
+ * Resolution order for @name (without /):
+ * 1. Check registered projects first - if found, routes to project's @root
+ * 2. Fall back to local persona lookup
+ *
+ * Returns:
+ * - channelsDir: The path to the channels directory (local or remote)
+ * - localChannelName: The channel name within that directory (e.g., @persona, #channel)
+ * - isProjectEntryPoint: True if routed to a project's entry point
+ * - projectName: The project name if routed to a project
+ */
+export declare function resolveChannelAddress(address: string, localChannelsDir: string): Promise<ResolvedChannelAddress>;
+/**
+ * List all registered projects
+ */
+export declare function listProjects(): Promise<Array<{
+    name: string;
+    path: string;
+}>>;
+/**
+ * Get the project name for a given agents directory path
+ * Returns null if the path doesn't match any registered project
+ */
+export declare function getProjectNameByPath(agentsDir: string): Promise<string | null>;
+/**
+ * A collision between a project name and a local persona name
+ */
+export interface NameCollision {
+    /** The conflicting name */
+    name: string;
+    /** Path to the registered project */
+    projectPath: string;
+    /** Path to the local persona */
+    personaPath: string;
+}
+/**
+ * Detect collisions between registered project names and local persona names.
+ * When a collision exists, @name will route to the project (projects take priority).
+ */
+export declare function detectNameCollisions(personaNames: string[]): Promise<NameCollision[]>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lib/registry.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2CAA2C;IAC3C,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAS7D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3E;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAyBxE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAsCjC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAC3C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CACtC,CAMA;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB1B"}

package/dist/lib/registry.js

@@ -0,0 +1,192 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+const CONFIG_DIR = join(homedir(), ".config", "dot-agents");
+const REGISTRY_FILE = "projects.yaml";
+/**
+ * Get path to the projects registry file
+ */
+export function getRegistryPath() {
+    return join(CONFIG_DIR, REGISTRY_FILE);
+}
+/**
+ * Load the project registry
+ */
+export async function loadRegistry() {
+    const registryPath = getRegistryPath();
+    try {
+        const content = await readFile(registryPath, "utf-8");
+        const data = parseYaml(content);
+        return data || { projects: {} };
+    }
+    catch {
+        return { projects: {} };
+    }
+}
+/**
+ * Save the project registry
+ */
+export async function saveRegistry(registry) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    const registryPath = getRegistryPath();
+    const content = stringifyYaml(registry);
+    await writeFile(registryPath, content, "utf-8");
+}
+/**
+ * Register a project in the registry
+ */
+export async function registerProject(name, path) {
+    const registry = await loadRegistry();
+    // Expand ~ to home directory
+    const expandedPath = path.startsWith("~")
+        ? join(homedir(), path.slice(1))
+        : resolve(path);
+    registry.projects[name] = expandedPath;
+    await saveRegistry(registry);
+}
+/**
+ * Unregister a project from the registry
+ */
+export async function unregisterProject(name) {
+    const registry = await loadRegistry();
+    if (name in registry.projects) {
+        delete registry.projects[name];
+        await saveRegistry(registry);
+        return true;
+    }
+    return false;
+}
+/**
+ * Resolve a project name to its .agents path
+ */
+export async function resolveProject(name) {
+    const registry = await loadRegistry();
+    const path = registry.projects[name];
+    if (!path) {
+        return null;
+    }
+    // Expand ~ if present (in case registry was edited manually)
+    return path.startsWith("~") ? join(homedir(), path.slice(1)) : path;
+}
+/**
+ * Parse a channel address that may include a project prefix
+ *
+ * Formats:
+ * - @persona (local DM)
+ * - #channel (local public channel)
+ * - @project/persona (cross-project DM)
+ * - #project/channel (cross-project public channel)
+ */
+export function parseChannelAddress(address) {
+    if (!address.startsWith("#") && !address.startsWith("@")) {
+        throw new Error(`Invalid channel address: ${address}. Must start with # or @`);
+    }
+    const type = address[0];
+    const rest = address.slice(1);
+    // Check for project/name format
+    const slashIndex = rest.indexOf("/");
+    if (slashIndex > 0) {
+        const project = rest.slice(0, slashIndex);
+        const name = rest.slice(slashIndex + 1);
+        if (!name) {
+            throw new Error(`Invalid channel address: ${address}. Missing channel/persona name after project.`);
+        }
+        return { project, type, name, original: address };
+    }
+    // Local channel
+    return { project: null, type, name: rest, original: address };
+}
+/**
+ * Resolve a channel address to a channels directory and local channel name
+ *
+ * Resolution order for @name (without /):
+ * 1. Check registered projects first - if found, routes to project's @root
+ * 2. Fall back to local persona lookup
+ *
+ * Returns:
+ * - channelsDir: The path to the channels directory (local or remote)
+ * - localChannelName: The channel name within that directory (e.g., @persona, #channel)
+ * - isProjectEntryPoint: True if routed to a project's entry point
+ * - projectName: The project name if routed to a project
+ */
+export async function resolveChannelAddress(address, localChannelsDir) {
+    const parsed = parseChannelAddress(address);
+    if (parsed.project === null) {
+        // Check if @name matches a registered project (unified resolution)
+        if (parsed.type === "@") {
+            const projectPath = await resolveProject(parsed.name);
+            if (projectPath) {
+                // Route to project's entry point (@root)
+                return {
+                    channelsDir: join(projectPath, "channels"),
+                    localChannelName: "@root",
+                    isProjectEntryPoint: true,
+                    projectName: parsed.name,
+                };
+            }
+        }
+        // Local channel (no project match or public channel)
+        return {
+            channelsDir: localChannelsDir,
+            localChannelName: address,
+        };
+    }
+    // Cross-project channel with explicit project/name format
+    const projectPath = await resolveProject(parsed.project);
+    if (!projectPath) {
+        throw new Error(`Unknown project: ${parsed.project}. Register it with: npx dot-agents projects add ${parsed.project} /path/to/project`);
+    }
+    return {
+        channelsDir: join(projectPath, "channels"),
+        localChannelName: `${parsed.type}${parsed.name}`,
+        projectName: parsed.project,
+    };
+}
+/**
+ * List all registered projects
+ */
+export async function listProjects() {
+    const registry = await loadRegistry();
+    return Object.entries(registry.projects).map(([name, path]) => ({
+        name,
+        path,
+    }));
+}
+/**
+ * Get the project name for a given agents directory path
+ * Returns null if the path doesn't match any registered project
+ */
+export async function getProjectNameByPath(agentsDir) {
+    const registry = await loadRegistry();
+    const normalizedPath = agentsDir.replace(/\/$/, ""); // Remove trailing slash
+    for (const [name, path] of Object.entries(registry.projects)) {
+        const normalizedProjectPath = path.replace(/\/$/, "");
+        if (normalizedPath === normalizedProjectPath) {
+            return name;
+        }
+    }
+    return null;
+}
+/**
+ * Detect collisions between registered project names and local persona names.
+ * When a collision exists, @name will route to the project (projects take priority).
+ */
+export async function detectNameCollisions(personaNames) {
+    const registry = await loadRegistry();
+    const collisions = [];
+    for (const [projectName, projectPath] of Object.entries(registry.projects)) {
+        // Check if any persona name matches the project name
+        for (const personaName of personaNames) {
+            if (personaName === projectName) {
+                collisions.push({
+                    name: projectName,
+                    projectPath: projectPath,
+                    personaPath: personaName,
+                });
+            }
+        }
+    }
+    return collisions;
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/lib/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAEtE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5D,MAAM,aAAa,GAAG,eAAe,CAAC;AAuBtC;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAoB,CAAC;QACnD,OAAO,IAAI,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAyB;IAC1D,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAY;IAEZ,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,6BAA6B;IAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;IACvC,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,IAAI,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,6DAA6D;IAC7D,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,4BAA4B,OAAO,0BAA0B,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAc,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE9B,gCAAgC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,4BAA4B,OAAO,+CAA+C,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpD,CAAC;IAED,gBAAgB;IAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC;AAgBD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,gBAAwB;IAExB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,mEAAmE;QACnE,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,WAAW,EAAE,CAAC;gBAChB,yCAAyC;gBACzC,OAAO;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;oBAC1C,gBAAgB,EAAE,OAAO;oBACzB,mBAAmB,EAAE,IAAI;oBACzB,WAAW,EAAE,MAAM,CAAC,IAAI;iBACzB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,OAAO;YACL,WAAW,EAAE,gBAAgB;YAC7B,gBAAgB,EAAE,OAAO;SAC1B,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oBAAoB,MAAM,CAAC,OAAO,mDAAmD,MAAM,CAAC,OAAO,mBAAmB,CACvH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QAC1C,gBAAgB,EAAE,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE;QAChD,WAAW,EAAE,MAAM,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAGhC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI;QACJ,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB;IAE7E,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,cAAc,KAAK,qBAAqB,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAcD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,UAAU,GAAoB,EAAE,CAAC;IAEvC,KAAK,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3E,qDAAqD;QACrD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;gBAChC,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,WAAW;oBACxB,WAAW,EAAE,WAAW;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/lib/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/lib/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/lib/registry.test.ts"],"names":[],"mappings":""}