fix reserved words when codegening

CHANGELOG.md

···
+### 0.3.1
+
+- Escape reserved keywords when generating code
+
 ### 0.3.0
 
 - New package `@typelex/cli`

packages/cli/src/commands/init.ts

···
 import { createInterface } from "readline";
 import pc from "picocolors";
 import { generateExternalsFile } from "../utils/externals-generator.js";
+import { escapeTypeSpecKeywords } from "../utils/escape-keywords.js";
 
 function gradientText(text: string): string {
   const colors = [
···
 }
 
 function createMainTemplate(namespace: string): string {
+  const escapedNamespace = escapeTypeSpecKeywords(namespace);
   return `import "@typelex/emitter";
 import "./externals.tsp";
 
-namespace ${namespace}.example.profile {
+namespace ${escapedNamespace}.example.profile {
   /** My profile. */
   @rec("literal:self")
   model Main {

packages/cli/src/utils/escape-keywords.ts

···
+/**
+ * Complete list of TypeSpec reserved keywords (67 total)
+ * Source: @typespec/compiler/src/core/scanner.ts
+ */
+const TYPESPEC_KEYWORDS = new Set([
+  // Active keywords
+  "import", "model", "scalar", "namespace", "using", "op", "enum", "alias",
+  "is", "interface", "union", "projection", "else", "if", "dec", "fn",
+  "const", "init", "extern", "extends", "true", "false", "return", "void",
+  "never", "unknown", "valueof", "typeof",
+  // Reserved keywords
+  "statemachine", "macro", "package", "metadata", "env", "arg", "declare",
+  "array", "struct", "record", "module", "mod", "sym", "context", "prop",
+  "property", "scenario", "pub", "sub", "typeref", "trait", "this", "self",
+  "super", "keyof", "with", "implements", "impl", "satisfies", "flag", "auto",
+  "partial", "private", "public", "protected", "internal", "sealed", "local",
+  "async"
+]);
+
+/**
+ * Escape TypeSpec reserved keywords in a namespace identifier
+ * Example: "pub.leaflet.example" -> "`pub`.leaflet.example"
+ */
+export function escapeTypeSpecKeywords(nsid: string): string {
+  return nsid.split('.').map(part =>
+    TYPESPEC_KEYWORDS.has(part) ? `\`${part}\`` : part
+  ).join('.');
+}

packages/cli/src/utils/externals-generator.ts

···
 import { resolve } from "path";
 import { writeFile, mkdir } from "fs/promises";
 import { findExternalLexicons, LexiconDoc, isTokenDef, isModelDef } from "./lexicon.js";
+import { escapeTypeSpecKeywords } from "./escape-keywords.js";
 
 /**
  * Convert camelCase to PascalCase
···
 
   for (const [nsid, lexicon] of sortedNamespaces) {
     lines.push("@external");
-    // Escape reserved keywords in namespace (like 'record')
-    const escapedNsid = nsid.replace(/\b(record|union|enum|interface|namespace|model|op|import|using|extends|is|scalar|alias|if|else|return|void|never|unknown|any|true|false|null)\b/g, '`$1`');
+    // Escape reserved keywords in namespace
+    const escapedNsid = escapeTypeSpecKeywords(nsid);
     lines.push(`namespace ${escapedNsid} {`);
 
     // Sort definitions for consistent output

packages/cli/test/scenarios/reserved-keywords/expected/lexicons/app/bsky/feed/post/record.json

···
+{
+  "lexicon": 1,
+  "id": "app.bsky.feed.post.record",
+  "defs": {
+    "main": {
+      "type": "object",
+      "properties": {
+        "text": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

packages/cli/test/scenarios/reserved-keywords/expected/lexicons/com/atproto/server/defs.json

···
+{
+  "lexicon": 1,
+  "id": "com.atproto.server.defs",
+  "defs": {
+    "inviteCode": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

packages/cli/test/scenarios/reserved-keywords/expected/lexicons/pub/leaflet/example/profile.json

···
+{
+  "lexicon": 1,
+  "id": "pub.leaflet.example.profile",
+  "defs": {
+    "main": {
+      "type": "record",
+      "key": "literal:self",
+      "record": {
+        "type": "object",
+        "properties": {
+          "description": {
+            "type": "string",
+            "maxGraphemes": 256,
+            "description": "Free-form profile description."
+          }
+        }
+      },
+      "description": "My profile."
+    }
+  }
+}

packages/cli/test/scenarios/reserved-keywords/expected/package.json

···
+{
+  "name": "reserved-keywords-test",
+  "type": "module",
+  "scripts": {
+    "build:typelex": "typelex compile pub.leaflet.*"
+  }
+}

packages/cli/test/scenarios/reserved-keywords/expected/typelex/externals.tsp

···
+import "@typelex/emitter";
+
+// Generated by typelex from ./lexicons (excluding pub.leaflet.*)
+// This file is auto-generated. Do not edit manually.
+
+@external
+namespace app.bsky.feed.post.`record` {
+  model Main { }
+}
+
+@external
+namespace com.atproto.server.defs {
+  model InviteCode { }
+}

packages/cli/test/scenarios/reserved-keywords/expected/typelex/main.tsp

···
+import "@typelex/emitter";
+import "./externals.tsp";
+
+namespace `pub`.leaflet.example.profile {
+  /** My profile. */
+  @rec("literal:self")
+  model Main {
+    /** Free-form profile description.*/
+    @maxGraphemes(256)
+    description?: string;
+  }
+}

packages/cli/test/scenarios/reserved-keywords/project/lexicons/app/bsky/feed/post/record.json

···
+{
+  "lexicon": 1,
+  "id": "app.bsky.feed.post.record",
+  "defs": {
+    "main": {
+      "type": "object",
+      "properties": {
+        "text": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

packages/cli/test/scenarios/reserved-keywords/project/lexicons/com/atproto/server/defs.json

···
+{
+  "lexicon": 1,
+  "id": "com.atproto.server.defs",
+  "defs": {
+    "inviteCode": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

packages/cli/test/scenarios/reserved-keywords/project/package.json

···
+{
+  "name": "reserved-keywords-test",
+  "type": "module"
+}

packages/cli/test/scenarios/reserved-keywords/test.ts

···
+export async function run(project) {
+  await project.init("pub.leaflet.*");
+
+  await project.runBuildScript();
+  await project.compareTo("expected");
+
+  // Second build - verify idempotency
+  await project.runBuildScript();
+  await project.compareTo("expected");
+}