link-agents 0.9.0

package/dist/utils/frontmatter.spec.js

@@ -0,0 +1,264 @@
+import { describe, it, expect } from "vitest";
+import { parseFrontmatter, reconstructMarkdown, transformForOpenCode, transformContentForClient, } from "./frontmatter.js";
+describe("parseFrontmatter", () => {
+    it("returns null frontmatter for content without frontmatter", () => {
+        const content = "# Hello\n\nNo frontmatter here.";
+        const result = parseFrontmatter(content);
+        expect(result.frontmatter).toBeNull();
+        expect(result.body).toBe(content);
+    });
+    it("parses simple key-value frontmatter", () => {
+        const content = `---
+name: test-agent
+description: A test agent
+---
+
+# Content`;
+        const result = parseFrontmatter(content);
+        expect(result.frontmatter).toEqual({
+            name: "test-agent",
+            description: "A test agent",
+        });
+        expect(result.body).toBe("\n# Content");
+    });
+    it("parses boolean values", () => {
+        const content = `---
+enabled: true
+disabled: false
+---
+`;
+        const result = parseFrontmatter(content);
+        expect(result.frontmatter?.enabled).toBe(true);
+        expect(result.frontmatter?.disabled).toBe(false);
+    });
+    it("parses numeric values", () => {
+        const content = `---
+count: 42
+ratio: 3.14
+---
+`;
+        const result = parseFrontmatter(content);
+        expect(result.frontmatter?.count).toBe(42);
+        expect(result.frontmatter?.ratio).toBe(3.14);
+    });
+});
+describe("reconstructMarkdown", () => {
+    it("creates valid frontmatter markdown", () => {
+        const frontmatter = { name: "test", enabled: true };
+        const body = "\n# Content";
+        const result = reconstructMarkdown(frontmatter, body);
+        expect(result).toBe(`---
+name: test
+enabled: true
+---
+
+# Content`);
+    });
+    it("handles object values", () => {
+        const frontmatter = { tools: { Read: true, Edit: false } };
+        const body = "";
+        const result = reconstructMarkdown(frontmatter, body);
+        expect(result).toContain("tools:");
+        expect(result).toContain("  Read: true");
+        expect(result).toContain("  Edit: false");
+    });
+    it("handles array values", () => {
+        const frontmatter = { items: ["one", "two", "three"] };
+        const body = "";
+        const result = reconstructMarkdown(frontmatter, body);
+        expect(result).toContain("items:");
+        expect(result).toContain("  - one");
+        expect(result).toContain("  - two");
+        expect(result).toContain("  - three");
+    });
+});
+describe("transformForOpenCode", () => {
+    it("transforms comma-separated tools string to object", () => {
+        const content = `---
+name: test
+tools: Read, Edit, Bash
+---
+
+# Content`;
+        const result = transformForOpenCode(content);
+        expect(result).toContain("tools:");
+        expect(result).toContain("  Read: true");
+        expect(result).toContain("  Edit: true");
+        expect(result).toContain("  Bash: true");
+        expect(result).not.toContain("Read, Edit, Bash");
+    });
+    it("transforms color name to hex", () => {
+        const content = `---
+name: test
+color: purple
+---
+
+# Content`;
+        const result = transformForOpenCode(content);
+        expect(result).toContain('color: "#9B59B6"');
+        expect(result).not.toContain("color: purple");
+    });
+    it("leaves already-hex colors unchanged", () => {
+        const content = `---
+name: test
+color: "#FF5733"
+---
+
+# Content`;
+        const result = transformForOpenCode(content);
+        expect(result).toContain('color: "#FF5733"');
+    });
+    it("preserves content without frontmatter", () => {
+        const content = "# No frontmatter\n\nJust content.";
+        const result = transformForOpenCode(content);
+        expect(result).toBe(content);
+    });
+    it("handles missing tools field gracefully", () => {
+        const content = `---
+name: test
+---
+
+# Content`;
+        const result = transformForOpenCode(content);
+        expect(result).toContain("name: test");
+        expect(result).not.toContain("tools:");
+    });
+    it("preserves body content after transformation", () => {
+        const content = `---
+name: test
+tools: Read
+---
+
+# Big Content
+
+This is a lot of text that should be preserved.
+
+## Section 2
+
+More content here.`;
+        const result = transformForOpenCode(content);
+        expect(result).toContain("# Big Content");
+        expect(result).toContain("This is a lot of text that should be preserved.");
+        expect(result).toContain("## Section 2");
+    });
+});
+describe("transformContentForClient", () => {
+    it("transforms agents for opencode", () => {
+        const content = `---
+tools: Read, Edit
+---
+
+# Agent`;
+        const result = transformContentForClient(content, "opencode", "agents");
+        expect(result).toContain("  Read: true");
+        expect(result).toContain("  Edit: true");
+    });
+    it("does not transform agents for other clients", () => {
+        const content = `---
+tools: Read, Edit
+---
+
+# Agent`;
+        const result = transformContentForClient(content, "cursor", "agents");
+        expect(result).toBe(content);
+    });
+    it("does not transform non-agent assets for opencode", () => {
+        const content = `---
+tools: Read, Edit
+---
+
+# Command`;
+        const result = transformContentForClient(content, "opencode", "commands");
+        expect(result).toBe(content);
+    });
+    describe("command frontmatter stripping", () => {
+        it("strips Cursor-specific keys when syncing commands to Claude", () => {
+            const content = `---
+description: Test command
+argument-hint: [plan]
+model: opus
+---
+
+# Test Command`;
+            const result = transformContentForClient(content, "claude", "commands");
+            expect(result).toContain("description: Test command");
+            expect(result).not.toContain("argument-hint");
+            expect(result).not.toContain("model:");
+            expect(result).toContain("# Test Command");
+        });
+        it("strips Cursor-specific keys when syncing commands to Codex", () => {
+            const content = `---
+description: Test
+argument-hint: [file]
+---
+
+# Test`;
+            const result = transformContentForClient(content, "codex", "commands");
+            expect(result).toContain("description: Test");
+            expect(result).not.toContain("argument-hint");
+        });
+        it("preserves Cursor-specific keys when syncing to Cursor", () => {
+            const content = `---
+description: Test
+argument-hint: [plan]
+model: opus
+---
+
+# Test`;
+            const result = transformContentForClient(content, "cursor", "commands");
+            expect(result).toBe(content);
+        });
+        it("preserves Cursor-specific keys when syncing to OpenCode", () => {
+            const content = `---
+description: Test
+argument-hint: [plan]
+model: opus
+---
+
+# Test`;
+            const result = transformContentForClient(content, "opencode", "commands");
+            expect(result).toBe(content);
+        });
+        it("strips Claude-specific keys when syncing commands to Cursor", () => {
+            const content = `---
+description: Test
+allowed_tools: read,write
+---
+
+# Test`;
+            const result = transformContentForClient(content, "cursor", "commands");
+            expect(result).toContain("description: Test");
+            expect(result).not.toContain("allowed_tools");
+        });
+        it("preserves body content after stripping", () => {
+            const content = `---
+description: Big command
+argument-hint: [plan]
+model: opus
+---
+
+# Main Title
+
+## Section 1
+
+Content here.
+
+## Section 2
+
+More content.`;
+            const result = transformContentForClient(content, "claude", "commands");
+            expect(result).toContain("# Main Title");
+            expect(result).toContain("## Section 1");
+            expect(result).toContain("Content here.");
+            expect(result).toContain("## Section 2");
+        });
+        it("handles commands without frontmatter", () => {
+            const content = `# No frontmatter
+
+Just a command.`;
+            const result = transformContentForClient(content, "claude", "commands");
+            expect(result).toBe(content);
+        });
+    });
+});
+//# sourceMappingURL=frontmatter.spec.js.map

package/dist/utils/frontmatter.spec.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,27 @@
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function readFileSafe(filePath: string): Promise<string | null>;
+export declare function writeFileSafe(filePath: string, contents: string): Promise<void>;
+export declare function hashContent(content: string): string;
+export declare function expandHome(inputPath: string): string;
+export declare function toFileUrl(filePath: string): string;
+export declare function getFileMtime(filePath: string): Promise<Date | null>;
+/**
+ * Create a backup of a file by copying it to .bak
+ * Returns the backup path if created, null if file didn't exist
+ */
+export declare function createBackup(filePath: string): Promise<string | null>;
+/**
+ * Restore a file from its backup
+ * Returns true if restored, false if backup didn't exist or failed
+ */
+export declare function restoreBackup(backupPath: string, targetPath: string): Promise<boolean>;
+/**
+ * Check if file content matches expected hash
+ */
+export declare function verifyFileHash(filePath: string, expectedContent: string): Promise<boolean>;
+/**
+ * Check if a command exists in PATH
+ * Uses execFile to avoid shell injection
+ */
+export declare function commandExists(command: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAaA,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM3E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAOzE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyB3E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrE"}

package/dist/utils/fs.js

@@ -0,0 +1,137 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+const BACKUP_PREFIX = "__SYNC_AGENTS_BACKUP_V1__\n";
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readFileSafe(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeFileSafe(filePath, contents) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, contents, "utf8");
+}
+export function hashContent(content) {
+    return crypto.createHash("sha1").update(content).digest("hex");
+}
+export function expandHome(inputPath) {
+    if (inputPath.startsWith("~")) {
+        return path.join(process.env.HOME ?? "", inputPath.slice(1));
+    }
+    return inputPath;
+}
+export function toFileUrl(filePath) {
+    return pathToFileURL(filePath).href;
+}
+export async function getFileMtime(filePath) {
+    try {
+        const stats = await fs.stat(filePath);
+        return stats.mtime;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create a backup of a file by copying it to .bak
+ * Returns the backup path if created, null if file didn't exist
+ */
+export async function createBackup(filePath) {
+    try {
+        const backupPath = `${filePath}.bak`;
+        const stats = await fs.lstat(filePath);
+        if (stats.isSymbolicLink()) {
+            const linkTarget = await fs.readlink(filePath);
+            await fs.writeFile(backupPath, serializeBackupPayload({ kind: "symlink", linkTarget }), "utf8");
+            return backupPath;
+        }
+        const content = await fs.readFile(filePath, "utf8");
+        await fs.writeFile(backupPath, serializeBackupPayload({ kind: "file", content }), "utf8");
+        return backupPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Restore a file from its backup
+ * Returns true if restored, false if backup didn't exist or failed
+ */
+export async function restoreBackup(backupPath, targetPath) {
+    try {
+        const backupContent = await fs.readFile(backupPath, "utf8");
+        const payload = parseBackupPayload(backupContent);
+        if (!payload) {
+            await writeFileSafe(targetPath, backupContent);
+            return true;
+        }
+        await fs.rm(targetPath, { force: true, recursive: true });
+        if (payload.kind === "symlink" && payload.linkTarget) {
+            await fs.mkdir(path.dirname(targetPath), { recursive: true });
+            await fs.symlink(payload.linkTarget, targetPath);
+            return true;
+        }
+        await writeFileSafe(targetPath, payload.content ?? "");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if file content matches expected hash
+ */
+export async function verifyFileHash(filePath, expectedContent) {
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        return hashContent(content) === hashContent(expectedContent);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a command exists in PATH
+ * Uses execFile to avoid shell injection
+ */
+export async function commandExists(command) {
+    const { execFile } = await import("node:child_process");
+    const { promisify } = await import("node:util");
+    const execFileAsync = promisify(execFile);
+    try {
+        const whichCmd = process.platform === "win32" ? "where" : "which";
+        await execFileAsync(whichCmd, [command]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function serializeBackupPayload(payload) {
+    return `${BACKUP_PREFIX}${JSON.stringify(payload)}`;
+}
+function parseBackupPayload(content) {
+    if (!content.startsWith(BACKUP_PREFIX)) {
+        return null;
+    }
+    try {
+        return JSON.parse(content.slice(BACKUP_PREFIX.length));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/fs.spec.d.ts

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

package/dist/utils/fs.spec.d.ts.map

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

package/dist/utils/fs.spec.js

@@ -0,0 +1,73 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { hashContent, commandExists, createBackup, restoreBackup, readFileSafe, } from "./fs.js";
+describe("fs utilities", () => {
+    const testDir = path.join(os.tmpdir(), "link-agents-fs-test");
+    beforeEach(async () => {
+        await fs.rm(testDir, { recursive: true, force: true });
+        await fs.mkdir(testDir, { recursive: true });
+    });
+    afterEach(async () => {
+        await fs.rm(testDir, { recursive: true, force: true });
+    });
+    describe("hashContent", () => {
+        it("should generate consistent hashes for same content", () => {
+            const content = "test content";
+            const hash1 = hashContent(content);
+            const hash2 = hashContent(content);
+            expect(hash1).toBe(hash2);
+        });
+        it("should generate different hashes for different content", () => {
+            const hash1 = hashContent("content 1");
+            const hash2 = hashContent("content 2");
+            expect(hash1).not.toBe(hash2);
+        });
+        it("should handle empty strings", () => {
+            const hash = hashContent("");
+            expect(hash).toBeDefined();
+            expect(typeof hash).toBe("string");
+            expect(hash.length).toBe(40);
+        });
+    });
+    describe("commandExists", () => {
+        it("should return true for common commands", async () => {
+            // 'node' should exist since we're running in Node.js
+            const exists = await commandExists("node");
+            expect(exists).toBe(true);
+        });
+        it("should return false for non-existent commands", async () => {
+            const exists = await commandExists("definitely-not-a-real-command-12345");
+            expect(exists).toBe(false);
+        });
+    });
+    describe("backup and restore", () => {
+        it("restores regular files from backup payloads", async () => {
+            const filePath = path.join(testDir, "agent.md");
+            await fs.writeFile(filePath, "original content", "utf8");
+            const backupPath = await createBackup(filePath);
+            expect(backupPath).toBe(`${filePath}.bak`);
+            await fs.writeFile(filePath, "changed content", "utf8");
+            const restored = await restoreBackup(backupPath, filePath);
+            expect(restored).toBe(true);
+            expect(await readFileSafe(filePath)).toBe("original content");
+        });
+        it("restores symlinks from backup payloads", async () => {
+            const sourcePath = path.join(testDir, "source.md");
+            const targetPath = path.join(testDir, "target.md");
+            await fs.writeFile(sourcePath, "source content", "utf8");
+            await fs.symlink("source.md", targetPath);
+            const backupPath = await createBackup(targetPath);
+            expect(backupPath).toBe(`${targetPath}.bak`);
+            await fs.rm(targetPath, { force: true });
+            await fs.writeFile(targetPath, "now a regular file", "utf8");
+            const restored = await restoreBackup(backupPath, targetPath);
+            expect(restored).toBe(true);
+            const stats = await fs.lstat(targetPath);
+            expect(stats.isSymbolicLink()).toBe(true);
+            expect(await fs.readlink(targetPath)).toBe("source.md");
+        });
+    });
+});
+//# sourceMappingURL=fs.spec.js.map

package/dist/utils/fs.spec.js.map

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

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Update .gitignore to include link-agents generated files.
+ * Only updates if there are project-level generated files.
+ */
+export declare function updateGitignore(projectRoot: string, generatedPaths: string[]): Promise<boolean>;
+/**
+ * Remove link-agents section from .gitignore.
+ */
+export declare function cleanGitignore(projectRoot: string): Promise<boolean>;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/utils/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB1E"}

package/dist/utils/gitignore.js

@@ -0,0 +1,63 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileExists, readFileSafe } from "./fs.js";
+const GITIGNORE_MARKER_START = "# link-agents generated files";
+const GITIGNORE_MARKER_END = "# end link-agents";
+/**
+ * Update .gitignore to include link-agents generated files.
+ * Only updates if there are project-level generated files.
+ */
+export async function updateGitignore(projectRoot, generatedPaths) {
+    // Only include paths relative to project root
+    const relativePaths = generatedPaths
+        .filter((p) => p.startsWith(projectRoot))
+        .map((p) => path.relative(projectRoot, p))
+        .filter((p) => p && !p.startsWith(".."));
+    if (relativePaths.length === 0) {
+        return false;
+    }
+    const gitignorePath = path.join(projectRoot, ".gitignore");
+    let content = (await readFileSafe(gitignorePath)) ?? "";
+    // Remove existing link-agents section
+    const startIdx = content.indexOf(GITIGNORE_MARKER_START);
+    const endIdx = content.indexOf(GITIGNORE_MARKER_END);
+    if (startIdx !== -1 && endIdx !== -1) {
+        content =
+            content.slice(0, startIdx) +
+                content.slice(endIdx + GITIGNORE_MARKER_END.length);
+    }
+    // Build new section
+    const newSection = [
+        "",
+        GITIGNORE_MARKER_START,
+        ...relativePaths.map((p) => `/${p}`),
+        GITIGNORE_MARKER_END,
+        "",
+    ].join("\n");
+    // Append to content
+    content = content.trimEnd() + newSection;
+    await fs.writeFile(gitignorePath, content, "utf8");
+    return true;
+}
+/**
+ * Remove link-agents section from .gitignore.
+ */
+export async function cleanGitignore(projectRoot) {
+    const gitignorePath = path.join(projectRoot, ".gitignore");
+    if (!(await fileExists(gitignorePath))) {
+        return false;
+    }
+    let content = (await readFileSafe(gitignorePath)) ?? "";
+    const startIdx = content.indexOf(GITIGNORE_MARKER_START);
+    const endIdx = content.indexOf(GITIGNORE_MARKER_END);
+    if (startIdx === -1 || endIdx === -1) {
+        return false;
+    }
+    content =
+        content.slice(0, startIdx) +
+            content.slice(endIdx + GITIGNORE_MARKER_END.length);
+    content = content.replace(/\n{3,}/g, "\n\n").trim() + "\n";
+    await fs.writeFile(gitignorePath, content, "utf8");
+    return true;
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/utils/gitignore.js.map

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

package/dist/utils/manifest.d.ts

@@ -0,0 +1,28 @@
+interface Manifest {
+    version: 1;
+    lastSync: string;
+    generatedFiles: string[];
+}
+export declare function readManifest(): Promise<Manifest>;
+export declare function writeManifest(manifest: Manifest): Promise<void>;
+export declare function updateManifest(generatedFiles: string[]): Promise<void>;
+/**
+ * Find files that were in the previous manifest but not in the current plan.
+ * These are "stale" files that should be cleaned up.
+ */
+export declare function findStaleFiles(currentFiles: string[]): Promise<string[]>;
+/**
+ * Remove stale files that are no longer in the sync plan.
+ * Returns list of removed files.
+ */
+export declare function pruneStaleFiles(currentFiles: string[]): Promise<string[]>;
+/**
+ * Clear the manifest (used by reset command).
+ */
+export declare function clearManifest(): Promise<void>;
+/**
+ * Get all files from manifest (for reset command).
+ */
+export declare function getManifestFiles(): Promise<string[]>;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/utils/manifest.ts"],"names":[],"mappings":"AAQA,UAAU,QAAQ;IAChB,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAUD,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAUtD;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED,wBAAsB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAG1D"}