framer-code-link 0.10.1 → 0.12.0

package/dist/index.mjs

@@ -1262,7 +1262,8 @@ var Installer = class {
 			this.ensurePrettierConfig(),
 			this.ensureFramerDeclarations(),
 			this.ensurePackageJson(),
-			this.ensureSkills()
+			this.ensureSkills(),
+			this.ensureGitignore()
 		]);
 		Promise.resolve().then(async () => {
 			await this.ensureReact18Types();
@@ -1416,6 +1417,27 @@ declare module "*.json"
 	async ensureSkills() {
 		await installSkills(this.projectDir);
 	}
+	async ensureGitignore() {
+		const gitignorePath = path.join(this.projectDir, ".gitignore");
+		try {
+			await fs.access(gitignorePath);
+			debug(".gitignore already exists");
+			return;
+		} catch {}
+		const content = [
+			"node_modules/",
+			"",
+			"# Framer Code Link",
+			".framer-sync-state.json",
+			".skills/",
+			".agents/skills/",
+			".claude/skills/",
+			".cursor/skills/",
+			""
+		].join("\n");
+		await fs.writeFile(gitignorePath, content);
+		debug("Created .gitignore");
+	}
 	async ensureReact18Types() {
 		const reactTypesDir = path.join(this.projectDir, "node_modules/@types/react");
 		const reactFiles = [
@@ -1877,8 +1899,8 @@ function hashContent(content) {
 function toPackageName(name) {
 	return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
 }
-function toDirName(name) {
-	return name.replace(/[^a-zA-Z0-9- ]/g, "-").replace(/^[-\s]+|[-\s]+$/g, "").replace(/-+/g, "-");
+function toDirectoryName(name) {
+	return name.replace(/[^a-zA-Z0-9-]/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
 }
 async function getProjectHashFromCwd() {
 	try {
@@ -1889,27 +1911,27 @@ async function getProjectHashFromCwd() {
 		return null;
 	}
 }
-async function findOrCreateProjectDir(projectHash, projectName, explicitDir) {
-	if (explicitDir) {
-		const resolved = path.resolve(explicitDir);
+async function findOrCreateProjectDirectory(projectHash, projectName, explicitDirectory) {
+	if (explicitDirectory) {
+		const resolved = path.resolve(explicitDirectory);
 		await fs.mkdir(path.join(resolved, "files"), { recursive: true });
 		return {
-			dir: resolved,
+			directory: resolved,
 			created: false
 		};
 	}
 	const cwd = process.cwd();
-	const existing = await findExistingProjectDir(cwd, projectHash);
+	const existing = await findExistingProjectDirectory(cwd, projectHash);
 	if (existing) return {
-		dir: existing,
+		directory: existing,
 		created: false
 	};
 	if (!projectName) throw new Error("Failed to get Project name. Pass --name <project name>.");
-	const dirName = toDirName(projectName);
+	const directoryName = toDirectoryName(projectName);
 	const pkgName = toPackageName(projectName);
 	const shortId = shortProjectHash(projectHash);
-	const projectDir = path.join(cwd, dirName || shortId);
-	await fs.mkdir(path.join(projectDir, "files"), { recursive: true });
+	const projectDirectory = path.join(cwd, directoryName || shortId);
+	await fs.mkdir(path.join(projectDirectory, "files"), { recursive: true });
 	const pkg = {
 		name: pkgName || shortId,
 		version: "1.0.0",
@@ -1917,19 +1939,19 @@ async function findOrCreateProjectDir(projectHash, projectName, explicitDir) {
 		shortProjectHash: shortId,
 		framerProjectName: projectName
 	};
-	await fs.writeFile(path.join(projectDir, "package.json"), JSON.stringify(pkg, null, 2));
+	await fs.writeFile(path.join(projectDirectory, "package.json"), JSON.stringify(pkg, null, 2));
 	return {
-		dir: projectDir,
+		directory: projectDirectory,
 		created: true
 	};
 }
-async function findExistingProjectDir(baseDir, projectHash) {
-	if (await matchesProject(path.join(baseDir, "package.json"), projectHash)) return baseDir;
-	const entries = await fs.readdir(baseDir, { withFileTypes: true });
+async function findExistingProjectDirectory(baseDirectory, projectHash) {
+	if (await matchesProject(path.join(baseDirectory, "package.json"), projectHash)) return baseDirectory;
+	const entries = await fs.readdir(baseDirectory, { withFileTypes: true });
 	for (const entry of entries) {
 		if (!entry.isDirectory()) continue;
-		const dir = path.join(baseDir, entry.name);
-		if (await matchesProject(path.join(dir, "package.json"), projectHash)) return dir;
+		const directory = path.join(baseDirectory, entry.name);
+		if (await matchesProject(path.join(directory, "package.json"), projectHash)) return directory;
 	}
 	return null;
 }
@@ -2351,9 +2373,9 @@ async function executeEffect(effect, context) {
 		case "INIT_WORKSPACE":
 			if (!config.projectDir) {
 				const projectName = config.explicitName ?? effect.projectInfo.projectName;
-				const result = await findOrCreateProjectDir(config.projectHash, projectName, config.explicitDir);
-				config.projectDir = result.dir;
-				config.projectDirCreated = result.created;
+				const directoryInfo = await findOrCreateProjectDirectory(config.projectHash, projectName, config.explicitDirectory);
+				config.projectDir = directoryInfo.directory;
+				config.projectDirCreated = directoryInfo.created;
 				config.filesDir = `${config.projectDir}/files`;
 				debug(`Files directory: ${config.filesDir}`);
 				await fs.mkdir(config.filesDir, { recursive: true });
@@ -2505,11 +2527,12 @@ async function executeEffect(effect, context) {
 				resetDisconnectState();
 				return [];
 			}
-			const relativeDir = config.projectDir ? "./" + (path.relative(process.cwd(), config.projectDir) || ".") : null;
-			if (effect.totalCount === 0 && relativeDir) if (config.projectDirCreated) success(`Created ${relativeDir} folder`);
-			else success(`Syncing to ${relativeDir} folder`);
-			else if (relativeDir && config.projectDirCreated) success(`Synced into ${relativeDir} (${effect.updatedCount} files added)`);
-			else if (relativeDir) success(`Synced into ${relativeDir} (${effect.updatedCount} files updated, ${effect.unchangedCount} unchanged)`);
+			const relative = config.projectDir ? path.relative(process.cwd(), config.projectDir) : null;
+			const relativeDirectory = relative != null ? relative ? "./" + relative : "." : null;
+			if (effect.totalCount === 0 && relativeDirectory) if (config.projectDirCreated) success(`Created ${relativeDirectory} folder`);
+			else success(`Syncing to ${relativeDirectory} folder`);
+			else if (relativeDirectory && config.projectDirCreated) success(`Synced into ${relativeDirectory} (${effect.updatedCount} files added)`);
+			else if (relativeDirectory) success(`Synced into ${relativeDirectory} (${effect.updatedCount} files updated, ${effect.unchangedCount} unchanged)`);
 			else success(`Synced ${effect.totalCount} files (${effect.updatedCount} updated, ${effect.unchangedCount} unchanged)`);
 			status("Watching for changes...");
 			return [];
@@ -2757,7 +2780,7 @@ program.name("framer-code-link").description("Sync Framer code components to you
 		filesDir: null,
 		dangerouslyAutoDelete: options.dangerouslyAutoDelete ?? false,
 		allowUnsupportedNpm: options.unsupportedNpm ?? false,
-		explicitDir: options.dir,
+		explicitDirectory: options.dir,
 		explicitName: options.name
 	};
 	if (config.dangerouslyAutoDelete) warn("Auto-delete mode enabled - files will be deleted without confirmation");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-code-link",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "CLI tool for syncing Framer code components - controller-centric architecture",
   "main": "dist/index.mjs",
   "type": "module",