@atproto/lex-builder 0.0.8 → 0.0.9

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @atproto/lex-builder
 
+## 0.0.9
+
+### Patch Changes
+
+- [#4501](https://github.com/bluesky-social/atproto/pull/4501) [`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Better prevent use of conflicting identifiers in generated code
+
+- [#4501](https://github.com/bluesky-social/atproto/pull/4501) [`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Add an `indexFile` option that allows generating an "index.ts" file that re-exports every tld namespaces.
+
+- [#4501](https://github.com/bluesky-social/atproto/pull/4501) [`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Ensure generated "import" identifiers start with a lower case letter
+
+- [#4501](https://github.com/bluesky-social/atproto/pull/4501) [`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Avoid escaping export identifier when it is a known global
+
+- Updated dependencies [[`2f78893`](https://github.com/bluesky-social/atproto/commit/2f78893ace3bbf14d4bac36837820ddb46658c98)]:
+  - @atproto/lex-schema@0.0.7
+  - @atproto/lex-document@0.0.8
+
 ## 0.0.8
 
 ### Patch Changes

package/dist/lex-builder.d.ts

@@ -3,6 +3,14 @@ import { FormatterOptions } from './formatter.js';
 import { LexDefBuilderOptions } from './lex-def-builder.js';
 import { LexiconDirectoryIndexerOptions } from './lexicon-directory-indexer.js';
 export type LexBuilderOptions = LexDefBuilderOptions & {
+    /**
+     * Whether to generate an index file at the root exporting all top-level
+     * namespaces.
+     *
+     * @note This could theoretically cause name conflicts if a
+     * @default false
+     */
+    indexFile?: boolean;
     importExt?: string;
     fileExt?: string;
 };

package/dist/lex-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lex-builder.d.ts","sourceRoot":"","sources":["../src/lex-builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAA;AAE7D,OAAO,EAAa,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,EAAiB,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EAEL,8BAA8B,EAC/B,MAAM,gCAAgC,CAAA;AAGvC,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,8BAA8B,GAChE,kBAAkB,CAAA;AAEpB,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qBAAa,UAAU;;IAOT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,iBAAsB;IAE5D,IAAI,OAAO,WAEV;IAED,IAAI,SAAS,WAEZ;IAEY,IAAI,CAAC,OAAO,EAAE,qBAAqB;IAkBnC,IAAI,CAAC,OAAO,EAAE,qBAAqB;IA4BhD,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,OAAO;YAID,gBAAgB;YA0ChB,cAAc;CAU7B"}
+{"version":3,"file":"lex-builder.d.ts","sourceRoot":"","sources":["../src/lex-builder.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAA;AAE7D,OAAO,EAAa,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,EAAiB,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EAEL,8BAA8B,EAC/B,MAAM,gCAAgC,CAAA;AAGvC,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG;IACrD;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,8BAA8B,GAChE,kBAAkB,CAAA;AAEpB,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qBAAa,UAAU;;IAOT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,iBAAsB;IAE5D,IAAI,OAAO,WAEV;IAED,IAAI,SAAS,WAEZ;IAEY,IAAI,CAAC,OAAO,EAAE,qBAAqB;IAkBnC,IAAI,CAAC,OAAO,EAAE,qBAAqB;IA4BhD,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,OAAO;YAID,gBAAgB;YAyDhB,cAAc;CAU7B"}

package/dist/lex-builder.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LexBuilder = void 0;
 const tslib_1 = require("tslib");
+const node_assert_1 = tslib_1.__importDefault(require("node:assert"));
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const ts_morph_1 = require("ts-morph");
@@ -78,6 +79,18 @@ class LexBuilder {
     }
     async createExportTree(doc) {
         const namespaces = doc.id.split('.');
+        if (this.options.indexFile) {
+            const indexFile = this.getFile(`/index${this.fileExt}`);
+            const tldNs = namespaces[0];
+            (0, node_assert_1.default)(tldNs !== 'index', 'The "indexFile" options cannot be used with namespaces using a ".index" tld.');
+            const tldNsSpecifier = `./${tldNs}${this.importExt}`;
+            if (!indexFile.getExportDeclaration(tldNsSpecifier)) {
+                indexFile.addExportDeclaration({
+                    moduleSpecifier: tldNsSpecifier,
+                    namespaceExport: (0, ts_lang_js_1.asNamespaceExport)(tldNs),
+                });
+            }
+        }
         // First create the parent namespaces
         for (let i = 0; i < namespaces.length - 1; i++) {
             const currentNs = namespaces[i];
@@ -89,9 +102,7 @@ class LexBuilder {
             if (!dec) {
                 file.addExportDeclaration({
                     moduleSpecifier: childModuleSpecifier,
-                    namespaceExport: (0, ts_lang_js_1.isSafeIdentifier)(childNs)
-                        ? childNs
-                        : JSON.stringify(childNs),
+                    namespaceExport: (0, ts_lang_js_1.asNamespaceExport)(childNs),
                 });
             }
         }

package/dist/lex-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"lex-builder.js","sourceRoot":"","sources":["../src/lex-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, rm, stat, writeFile } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { IndentationText, Project } from 'ts-morph'\nimport { LexiconDocument, LexiconIndexer } from '@atproto/lex-document'\nimport { BuildFilterOptions, buildFilter } from './filter.js'\nimport { FilteredIndexer } from './filtered-indexer.js'\nimport { Formatter, FormatterOptions } from './formatter.js'\nimport { LexDefBuilder, LexDefBuilderOptions } from './lex-def-builder.js'\nimport {\n  LexiconDirectoryIndexer,\n  LexiconDirectoryIndexerOptions,\n} from './lexicon-directory-indexer.js'\nimport { isSafeIdentifier } from './ts-lang.js'\n\nexport type LexBuilderOptions = LexDefBuilderOptions & {\n  importExt?: string\n  fileExt?: string\n}\n\nexport type LexBuilderLoadOptions = LexiconDirectoryIndexerOptions &\n  BuildFilterOptions\n\nexport type LexBuilderSaveOptions = FormatterOptions & {\n  out: string\n  clear?: boolean\n  override?: boolean\n}\n\nexport class LexBuilder {\n  readonly #imported = new Set<string>()\n  readonly #project = new Project({\n    useInMemoryFileSystem: true,\n    manipulationSettings: { indentationText: IndentationText.TwoSpaces },\n  })\n\n  constructor(private readonly options: LexBuilderOptions = {}) {}\n\n  get fileExt() {\n    return this.options.fileExt ?? '.ts'\n  }\n\n  get importExt() {\n    return this.options.importExt ?? '.js'\n  }\n\n  public async load(options: LexBuilderLoadOptions) {\n    await using indexer = new FilteredIndexer(\n      new LexiconDirectoryIndexer(options),\n      buildFilter(options),\n    )\n\n    for await (const doc of indexer) {\n      if (!this.#imported.has(doc.id)) {\n        this.#imported.add(doc.id)\n      } else {\n        throw new Error(`Duplicate lexicon document id: ${doc.id}`)\n      }\n\n      await this.createDefsFile(doc, indexer)\n      await this.createExportTree(doc)\n    }\n  }\n\n  public async save(options: LexBuilderSaveOptions) {\n    const files = this.#project.getSourceFiles()\n\n    const destination = resolve(options.out)\n\n    if (options.clear) {\n      await rm(destination, { recursive: true, force: true })\n    } else if (!options.override) {\n      await Promise.all(\n        files.map(async (f) =>\n          assertNotFileExists(join(destination, f.getFilePath())),\n        ),\n      )\n    }\n\n    const formatter = new Formatter(options)\n\n    await Promise.all(\n      Array.from(files, async (file) => {\n        const filePath = join(destination, file.getFilePath())\n        const content = await formatter.format(file.getFullText())\n        await mkdir(join(filePath, '..'), { recursive: true })\n        await rm(filePath, { recursive: true, force: true })\n        await writeFile(filePath, content, 'utf8')\n      }),\n    )\n  }\n\n  private createFile(path: string) {\n    return this.#project.createSourceFile(path)\n  }\n\n  private getFile(path: string) {\n    return this.#project.getSourceFile(path) || this.createFile(path)\n  }\n\n  private async createExportTree(doc: LexiconDocument) {\n    const namespaces = doc.id.split('.')\n\n    // First create the parent namespaces\n    for (let i = 0; i < namespaces.length - 1; i++) {\n      const currentNs = namespaces[i]\n      const childNs = namespaces[i + 1]\n\n      const path = join('/', ...namespaces.slice(0, i + 1))\n      const file = this.getFile(`${path}${this.fileExt}`)\n\n      const childModuleSpecifier = `./${currentNs}/${childNs}${this.importExt}`\n      const dec = file.getExportDeclaration(childModuleSpecifier)\n      if (!dec) {\n        file.addExportDeclaration({\n          moduleSpecifier: childModuleSpecifier,\n          namespaceExport: isSafeIdentifier(childNs)\n            ? childNs\n            : JSON.stringify(childNs),\n        })\n      }\n    }\n\n    // The child file exports the schemas (as *)\n    const path = join('/', ...namespaces)\n    const file = this.getFile(`${path}${this.fileExt}`)\n\n    file.addExportDeclaration({\n      moduleSpecifier: `./${namespaces.at(-1)}.defs${this.importExt}`,\n    })\n\n    // @NOTE Individual exports exports from the defs file might conflict with\n    // child namespaces. For this reason, we also add a namespace export for the\n    // defs (export * as $defs from './xyz.defs'). This is an escape hatch\n    // allowing to still access the definitions if a hash get shadowed by a\n    // child namespace.\n    file.addExportDeclaration({\n      moduleSpecifier: `./${namespaces.at(-1)}.defs${this.importExt}`,\n      namespaceExport: '$defs',\n    })\n  }\n\n  private async createDefsFile(\n    doc: LexiconDocument,\n    indexer: LexiconIndexer,\n  ): Promise<void> {\n    const path = join('/', ...doc.id.split('.'))\n    const file = this.createFile(`${path}.defs${this.fileExt}`)\n\n    const fileBuilder = new LexDefBuilder(this.options, file, doc, indexer)\n    await fileBuilder.build()\n  }\n}\n\nasync function assertNotFileExists(file: string): Promise<void> {\n  try {\n    await stat(file)\n    throw new Error(`File already exists: ${file}`)\n  } catch (err) {\n    if (err instanceof Error && 'code' in err && err.code === 'ENOENT') return\n    throw err\n  }\n}\n"]}
+{"version":3,"file":"lex-builder.js","sourceRoot":"","sources":["../src/lex-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'node:assert'\nimport { mkdir, rm, stat, writeFile } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { IndentationText, Project } from 'ts-morph'\nimport { LexiconDocument, LexiconIndexer } from '@atproto/lex-document'\nimport { BuildFilterOptions, buildFilter } from './filter.js'\nimport { FilteredIndexer } from './filtered-indexer.js'\nimport { Formatter, FormatterOptions } from './formatter.js'\nimport { LexDefBuilder, LexDefBuilderOptions } from './lex-def-builder.js'\nimport {\n  LexiconDirectoryIndexer,\n  LexiconDirectoryIndexerOptions,\n} from './lexicon-directory-indexer.js'\nimport { asNamespaceExport } from './ts-lang.js'\n\nexport type LexBuilderOptions = LexDefBuilderOptions & {\n  /**\n   * Whether to generate an index file at the root exporting all top-level\n   * namespaces.\n   *\n   * @note This could theoretically cause name conflicts if a\n   * @default false\n   */\n  indexFile?: boolean\n  importExt?: string\n  fileExt?: string\n}\n\nexport type LexBuilderLoadOptions = LexiconDirectoryIndexerOptions &\n  BuildFilterOptions\n\nexport type LexBuilderSaveOptions = FormatterOptions & {\n  out: string\n  clear?: boolean\n  override?: boolean\n}\n\nexport class LexBuilder {\n  readonly #imported = new Set<string>()\n  readonly #project = new Project({\n    useInMemoryFileSystem: true,\n    manipulationSettings: { indentationText: IndentationText.TwoSpaces },\n  })\n\n  constructor(private readonly options: LexBuilderOptions = {}) {}\n\n  get fileExt() {\n    return this.options.fileExt ?? '.ts'\n  }\n\n  get importExt() {\n    return this.options.importExt ?? '.js'\n  }\n\n  public async load(options: LexBuilderLoadOptions) {\n    await using indexer = new FilteredIndexer(\n      new LexiconDirectoryIndexer(options),\n      buildFilter(options),\n    )\n\n    for await (const doc of indexer) {\n      if (!this.#imported.has(doc.id)) {\n        this.#imported.add(doc.id)\n      } else {\n        throw new Error(`Duplicate lexicon document id: ${doc.id}`)\n      }\n\n      await this.createDefsFile(doc, indexer)\n      await this.createExportTree(doc)\n    }\n  }\n\n  public async save(options: LexBuilderSaveOptions) {\n    const files = this.#project.getSourceFiles()\n\n    const destination = resolve(options.out)\n\n    if (options.clear) {\n      await rm(destination, { recursive: true, force: true })\n    } else if (!options.override) {\n      await Promise.all(\n        files.map(async (f) =>\n          assertNotFileExists(join(destination, f.getFilePath())),\n        ),\n      )\n    }\n\n    const formatter = new Formatter(options)\n\n    await Promise.all(\n      Array.from(files, async (file) => {\n        const filePath = join(destination, file.getFilePath())\n        const content = await formatter.format(file.getFullText())\n        await mkdir(join(filePath, '..'), { recursive: true })\n        await rm(filePath, { recursive: true, force: true })\n        await writeFile(filePath, content, 'utf8')\n      }),\n    )\n  }\n\n  private createFile(path: string) {\n    return this.#project.createSourceFile(path)\n  }\n\n  private getFile(path: string) {\n    return this.#project.getSourceFile(path) || this.createFile(path)\n  }\n\n  private async createExportTree(doc: LexiconDocument) {\n    const namespaces = doc.id.split('.')\n\n    if (this.options.indexFile) {\n      const indexFile = this.getFile(`/index${this.fileExt}`)\n\n      const tldNs = namespaces[0]!\n      assert(\n        tldNs !== 'index',\n        'The \"indexFile\" options cannot be used with namespaces using a \".index\" tld.',\n      )\n      const tldNsSpecifier = `./${tldNs}${this.importExt}`\n      if (!indexFile.getExportDeclaration(tldNsSpecifier)) {\n        indexFile.addExportDeclaration({\n          moduleSpecifier: tldNsSpecifier,\n          namespaceExport: asNamespaceExport(tldNs),\n        })\n      }\n    }\n\n    // First create the parent namespaces\n    for (let i = 0; i < namespaces.length - 1; i++) {\n      const currentNs = namespaces[i]\n      const childNs = namespaces[i + 1]\n\n      const path = join('/', ...namespaces.slice(0, i + 1))\n      const file = this.getFile(`${path}${this.fileExt}`)\n\n      const childModuleSpecifier = `./${currentNs}/${childNs}${this.importExt}`\n      const dec = file.getExportDeclaration(childModuleSpecifier)\n      if (!dec) {\n        file.addExportDeclaration({\n          moduleSpecifier: childModuleSpecifier,\n          namespaceExport: asNamespaceExport(childNs),\n        })\n      }\n    }\n\n    // The child file exports the schemas (as *)\n    const path = join('/', ...namespaces)\n    const file = this.getFile(`${path}${this.fileExt}`)\n\n    file.addExportDeclaration({\n      moduleSpecifier: `./${namespaces.at(-1)}.defs${this.importExt}`,\n    })\n\n    // @NOTE Individual exports exports from the defs file might conflict with\n    // child namespaces. For this reason, we also add a namespace export for the\n    // defs (export * as $defs from './xyz.defs'). This is an escape hatch\n    // allowing to still access the definitions if a hash get shadowed by a\n    // child namespace.\n    file.addExportDeclaration({\n      moduleSpecifier: `./${namespaces.at(-1)}.defs${this.importExt}`,\n      namespaceExport: '$defs',\n    })\n  }\n\n  private async createDefsFile(\n    doc: LexiconDocument,\n    indexer: LexiconIndexer,\n  ): Promise<void> {\n    const path = join('/', ...doc.id.split('.'))\n    const file = this.createFile(`${path}.defs${this.fileExt}`)\n\n    const fileBuilder = new LexDefBuilder(this.options, file, doc, indexer)\n    await fileBuilder.build()\n  }\n}\n\nasync function assertNotFileExists(file: string): Promise<void> {\n  try {\n    await stat(file)\n    throw new Error(`File already exists: ${file}`)\n  } catch (err) {\n    if (err instanceof Error && 'code' in err && err.code === 'ENOENT') return\n    throw err\n  }\n}\n"]}

package/dist/ref-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ref-resolver.d.ts","sourceRoot":"","sources":["../src/ref-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAUvE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,qBAAa,WAAW;;IAEpB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;gBAHP,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,kBAAkB;IAGrC,SAAgB,OAAO,QACT,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,CAW1C;IAGD,OAAO,CAAC,4BAA4B;IASpC;;;OAGG;IACH,SAAgB,YAAY,SACb,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,CAsD3C;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CA6B/B;IAED,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iCAAiC;IAazC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,oBAAoB;CAe7B;AAoBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAU9D"}
+{"version":3,"file":"ref-resolver.d.ts","sourceRoot":"","sources":["../src/ref-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAWvE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,qBAAa,WAAW;;IAEpB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;gBAHP,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,kBAAkB;IAGrC,SAAgB,OAAO,QACT,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,CAW1C;IAGD,OAAO,CAAC,4BAA4B;IASpC;;;OAGG;IACH,SAAgB,YAAY,SACb,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,CAsD3C;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CA6B/B;IAED,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iCAAiC;IAazC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,oBAAoB;CAe7B;AAoBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAU9D"}

package/dist/ref-resolver.js

@@ -238,11 +238,15 @@ function getPublicIdentifiers(hash) {
     return { varName, typeName };
 }
 function asSafeDefinitionIdentifier(name) {
-    if ((0, ts_lang_js_1.isSafeIdentifier)(name) && (0, ts_lang_js_1.isSafeIdentifier)((0, util_js_1.ucFirst)(name)))
+    if ((0, util_js_1.startsWithLowerLetter)(name) &&
+        (0, ts_lang_js_1.isSafeIdentifier)(name) &&
+        (0, ts_lang_js_1.isSafeIdentifier)((0, util_js_1.ucFirst)(name))) {
         return name;
+    }
     const camel = (0, util_js_1.toCamelCase)(name);
-    if ((0, ts_lang_js_1.isSafeIdentifier)(camel) && (0, ts_lang_js_1.isSafeIdentifier)((0, util_js_1.ucFirst)(camel)))
+    if ((0, ts_lang_js_1.isSafeIdentifier)(camel) && (0, ts_lang_js_1.isSafeIdentifier)((0, util_js_1.ucFirst)(camel))) {
         return camel;
+    }
     return undefined;
 }
 //# sourceMappingURL=ref-resolver.js.map

package/dist/ref-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"ref-resolver.js","sourceRoot":"","sources":["../src/ref-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'node:assert'\nimport { join } from 'node:path'\nimport { SourceFile } from 'ts-morph'\nimport { LexiconDocument, LexiconIndexer } from '@atproto/lex-document'\nimport { isReservedWord, isSafeIdentifier } from './ts-lang.js'\nimport {\n  asRelativePath,\n  memoize,\n  toCamelCase,\n  toPascalCase,\n  ucFirst,\n} from './util.js'\n\nexport type RefResolverOptions = {\n  importExt?: string\n}\n\nexport type ResolvedRef = {\n  varName: string\n  typeName: string\n}\n\n/**\n * Utility class to resolve lexicon references to TypeScript identifiers,\n * generating \"import\" statements as needed.\n */\nexport class RefResolver {\n  constructor(\n    private doc: LexiconDocument,\n    private file: SourceFile,\n    private indexer: LexiconIndexer,\n    private options: RefResolverOptions,\n  ) {}\n\n  public readonly resolve = memoize(\n    async (ref: string): Promise<ResolvedRef> => {\n      const [nsid, hash = 'main'] = ref.split('#')\n\n      if (nsid === '' || nsid === this.doc.id) {\n        return this.resolveLocal(hash)\n      } else {\n        // @NOTE: Normalize (#main fragment) to ensure proper memoization\n        const fullRef = `${nsid}#${hash}`\n        return this.resolveExternal(fullRef)\n      }\n    },\n  )\n\n  #defCounters = new Map<string, number>()\n  private nextSafeDefinitionIdentifier(safeIdentifier: string) {\n    const count = this.#defCounters.get(safeIdentifier) ?? 0\n    this.#defCounters.set(safeIdentifier, count + 1)\n    // @NOTE We don't need to check against local declarations in the file here\n    // since we are using a naming system that should guarantee no other\n    // identifier has a <safeIdentifier>$<number> format.\n    return `${safeIdentifier}$${count}`\n  }\n\n  /**\n   * @note The returned `typeName` and `varName` are *both* guaranteed to be\n   * valid TypeScript identifiers.\n   */\n  public readonly resolveLocal = memoize(\n    async (hash: string): Promise<ResolvedRef> => {\n      const hashes = Object.keys(this.doc.defs)\n\n      if (!hashes.includes(hash)) {\n        throw new Error(`Definition ${hash} not found in ${this.doc.id}`)\n      }\n\n      // Because we are using predictable \"public\" identifiers for type names,\n      // we need to ensure there are no conflicts between different definitions\n      // in the same lexicon document.\n      //\n      // @NOTE It should be possible to implement a way to generate\n      // non-conflicting type names for all public (type) identifiers in a\n      // project. However, this would add a lot of complexity to the code\n      // generation process, and the likelihood of such conflicts happening in\n      // practice is very low, so we opt for a simpler approach of just throwing\n      // an error if a conflict is detected.\n      const pub = getPublicIdentifiers(hash)\n      for (const otherHash of hashes) {\n        if (otherHash === hash) continue\n        const otherPub = getPublicIdentifiers(otherHash)\n        if (otherPub.typeName === pub.typeName) {\n          throw new Error(\n            `Conflicting type names for definitions #${hash} and #${otherHash} in ${this.doc.id}`,\n          )\n        }\n      }\n\n      // Try to keep and identifier that resembles the original hash as identifier\n      const safeIdentifier = asSafeDefinitionIdentifier(hash)\n\n      // If the safe identifier is not conflicting with other definition names,\n      // or reserved words, we can use it as-is. Otherwise, we need to generate\n      // a unique safe identifier.\n      const varName = safeIdentifier\n        ? !hashes.some((otherHash) => {\n            if (otherHash === hash) return false\n            const otherIdentifier = asSafeDefinitionIdentifier(otherHash)\n            return otherIdentifier === safeIdentifier\n          })\n          ? // Safe identifier can be used as-is as it does not conflict with\n            // other definition names\n            safeIdentifier\n          : // In order to keep identifiers stable, we use the safe identifier\n            // as base, and append a counter to avoid conflicts\n            this.nextSafeDefinitionIdentifier(safeIdentifier)\n        : // hash only contained unsafe characters, generate a safe one\n          this.nextSafeDefinitionIdentifier('def')\n\n      const typeName = ucFirst(varName)\n      assert(varName !== typeName, 'Variable and type name should be different')\n\n      return { varName, typeName }\n    },\n  )\n\n  /**\n   * @note Since this is a memoized function, and is used to generate the name\n   * of local variables, we should avoid returning different results for\n   * similar, but non strictly equal, inputs (eg. normalized / non-normalized).\n   * @see {@link resolve}\n   */\n  private readonly resolveExternal = memoize(\n    async (fullRef: string): Promise<ResolvedRef> => {\n      const [nsid, hash] = fullRef.split('#')\n      const moduleSpecifier = `${asRelativePath(\n        this.file.getDirectoryPath(),\n        join('/', ...nsid.split('.')),\n      )}.defs${this.options.importExt ?? '.js'}`\n\n      // Lets first make sure the referenced lexicon exists\n      const srcDoc = await this.indexer.get(nsid)\n      const srcDef = Object.hasOwn(srcDoc.defs, hash) ? srcDoc.defs[hash] : null\n      if (!srcDef) {\n        throw new Error(\n          `Missing def \"${hash}\" in \"${nsid}\" (referenced from ${this.doc.id})`,\n        )\n      }\n\n      // import * as <nsIdentifier> from './<moduleSpecifier>'\n      const nsIdentifier = this.getNsIdentifier(nsid, moduleSpecifier)\n\n      const publicIds = getPublicIdentifiers(hash)\n\n      return {\n        varName: isSafeIdentifier(publicIds.varName)\n          ? `${nsIdentifier}.${publicIds.varName}`\n          : `${nsIdentifier}[${JSON.stringify(publicIds.varName)}]`,\n        typeName: `${nsIdentifier}.${publicIds.typeName}`,\n      }\n    },\n  )\n\n  private getNsIdentifier(nsid: string, moduleSpecifier: string) {\n    const namespaceImportDeclaration =\n      this.file.getImportDeclaration(\n        (imp) =>\n          !imp.isTypeOnly() &&\n          imp.getModuleSpecifierValue() === moduleSpecifier &&\n          imp.getNamespaceImport() != null,\n      ) ||\n      this.file.addImportDeclaration({\n        moduleSpecifier,\n        namespaceImport: this.computeSafeNamespaceIdentifierFor(nsid),\n      })\n\n    return namespaceImportDeclaration.getNamespaceImport()!.getText()\n  }\n\n  #nsIdentifiersCounters = new Map<string, number>()\n  private computeSafeNamespaceIdentifierFor(nsid: string) {\n    const baseName = nsidToIdentifier(nsid) || 'NS'\n\n    let name = baseName\n    while (this.isConflictingIdentifier(name)) {\n      const count = this.#nsIdentifiersCounters.get(baseName) ?? 0\n      this.#nsIdentifiersCounters.set(baseName, count + 1)\n      name = `${baseName}$$${count}`\n    }\n\n    return name\n  }\n\n  private isConflictingIdentifier(name: string) {\n    return (\n      this.conflictsWithKeywords(name) ||\n      this.conflictsWithUtils(name) ||\n      this.conflictsWithLocalDefs(name) ||\n      this.conflictsWithLocalDeclarations(name) ||\n      this.conflictsWithImports(name)\n    )\n  }\n\n  private conflictsWithKeywords(name: string) {\n    return isReservedWord(name)\n  }\n\n  private conflictsWithUtils(name: string) {\n    // Do not allow \"Main\" as imported ns identifier since it has a special\n    // meaning in the context of lexicon definitions.\n    if (name === 'Main') return true\n\n    // When \"useRecordExport\" returns true, an export named \"Record\" will be\n    // used in addition to the hash named export. So we need to make sure both\n    // names are not conflicting with local variables.\n    if (name === 'Record') return true\n\n    // Utility functions generated for lexicon schemas are prefixed with \"$\"\n    return name.startsWith('$')\n  }\n\n  private conflictsWithLocalDefs(name: string) {\n    return Object.keys(this.doc.defs).some((hash) => {\n      const identifier = toCamelCase(hash)\n\n      // A safe identifier will be generated, no risk of conflict.\n      if (!identifier) return false\n\n      // The imported name conflicts with a local definition name\n      if (identifier === name || `_${identifier}` === name) return true\n\n      // The imported name conflicts with the type name of a local definition\n      const typeName = ucFirst(identifier)\n      if (typeName === name || `_${typeName}` === name) return true\n\n      return false\n    })\n  }\n\n  private conflictsWithLocalDeclarations(name: string) {\n    return (\n      this.file.getVariableDeclarations().some((v) => v.getName() === name) ||\n      this.file\n        .getVariableStatements()\n        .some((vs) => vs.getDeclarations().some((d) => d.getName() === name)) ||\n      this.file.getTypeAliases().some((t) => t.getName() === name) ||\n      this.file.getInterfaces().some((i) => i.getName() === name) ||\n      this.file.getClasses().some((c) => c.getName() === name) ||\n      this.file.getFunctions().some((f) => f.getName() === name) ||\n      this.file.getEnums().some((e) => e.getName() === name)\n    )\n  }\n\n  private conflictsWithImports(name: string) {\n    return this.file.getImportDeclarations().some(\n      (imp) =>\n        // import name from '...'\n        imp.getDefaultImport()?.getText() === name ||\n        // import * as name from '...'\n        imp.getNamespaceImport()?.getText() === name ||\n        imp.getNamedImports().some(\n          (named) =>\n            // import { name } from '...'\n            // import { foo as name } from '...'\n            (named.getAliasNode()?.getText() ?? named.getName()) === name,\n        ),\n    )\n  }\n}\n\n/**\n * @see {@link https://atproto.com/specs/nsid NSID syntax spec}\n */\nfunction nsidToIdentifier(nsid: string) {\n  const parts = nsid.split('.')\n\n  // By default, try to keep only to the last two segments of the NSID as\n  // contextual information. If those do not form a safe identifier (typically\n  // because they start with a digit), try with more segments until we reach the\n  // full NSID.\n  for (let i = 2; i < parts.length; i++) {\n    const identifier = toPascalCase(parts.slice(-i).join('.'))\n    if (isSafeIdentifier(identifier)) return identifier\n  }\n\n  return undefined\n}\n\n/**\n * Generates predictable public identifiers for a given definition hash.\n *\n * @note The returned `typeName` is guaranteed to be a valid TypeScript\n * identifier. `varName` may not be a valid identifier (eg. if the hash contains\n * unsafe characters), and may need to be accessed using string indexing.\n */\nexport function getPublicIdentifiers(hash: string): ResolvedRef {\n  const varName = hash\n  // @NOTE Type names *must* be valid TypeScript identifiers (this is because,\n  // unlike variable names, we cannot use string indexing to access exported\n  // types).\n  const typeName = toPascalCase(hash)\n  if (!typeName || varName === typeName || !isSafeIdentifier(typeName)) {\n    return { varName, typeName: `Def${typeName}` }\n  }\n  return { varName, typeName }\n}\n\nfunction asSafeDefinitionIdentifier(name: string) {\n  if (isSafeIdentifier(name) && isSafeIdentifier(ucFirst(name))) return name\n  const camel = toCamelCase(name)\n  if (isSafeIdentifier(camel) && isSafeIdentifier(ucFirst(camel))) return camel\n  return undefined\n}\n"]}
+{"version":3,"file":"ref-resolver.js","sourceRoot":"","sources":["../src/ref-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'node:assert'\nimport { join } from 'node:path'\nimport { SourceFile } from 'ts-morph'\nimport { LexiconDocument, LexiconIndexer } from '@atproto/lex-document'\nimport { isReservedWord, isSafeIdentifier } from './ts-lang.js'\nimport {\n  asRelativePath,\n  memoize,\n  startsWithLowerLetter,\n  toCamelCase,\n  toPascalCase,\n  ucFirst,\n} from './util.js'\n\nexport type RefResolverOptions = {\n  importExt?: string\n}\n\nexport type ResolvedRef = {\n  varName: string\n  typeName: string\n}\n\n/**\n * Utility class to resolve lexicon references to TypeScript identifiers,\n * generating \"import\" statements as needed.\n */\nexport class RefResolver {\n  constructor(\n    private doc: LexiconDocument,\n    private file: SourceFile,\n    private indexer: LexiconIndexer,\n    private options: RefResolverOptions,\n  ) {}\n\n  public readonly resolve = memoize(\n    async (ref: string): Promise<ResolvedRef> => {\n      const [nsid, hash = 'main'] = ref.split('#')\n\n      if (nsid === '' || nsid === this.doc.id) {\n        return this.resolveLocal(hash)\n      } else {\n        // @NOTE: Normalize (#main fragment) to ensure proper memoization\n        const fullRef = `${nsid}#${hash}`\n        return this.resolveExternal(fullRef)\n      }\n    },\n  )\n\n  #defCounters = new Map<string, number>()\n  private nextSafeDefinitionIdentifier(safeIdentifier: string) {\n    const count = this.#defCounters.get(safeIdentifier) ?? 0\n    this.#defCounters.set(safeIdentifier, count + 1)\n    // @NOTE We don't need to check against local declarations in the file here\n    // since we are using a naming system that should guarantee no other\n    // identifier has a <safeIdentifier>$<number> format.\n    return `${safeIdentifier}$${count}`\n  }\n\n  /**\n   * @note The returned `typeName` and `varName` are *both* guaranteed to be\n   * valid TypeScript identifiers.\n   */\n  public readonly resolveLocal = memoize(\n    async (hash: string): Promise<ResolvedRef> => {\n      const hashes = Object.keys(this.doc.defs)\n\n      if (!hashes.includes(hash)) {\n        throw new Error(`Definition ${hash} not found in ${this.doc.id}`)\n      }\n\n      // Because we are using predictable \"public\" identifiers for type names,\n      // we need to ensure there are no conflicts between different definitions\n      // in the same lexicon document.\n      //\n      // @NOTE It should be possible to implement a way to generate\n      // non-conflicting type names for all public (type) identifiers in a\n      // project. However, this would add a lot of complexity to the code\n      // generation process, and the likelihood of such conflicts happening in\n      // practice is very low, so we opt for a simpler approach of just throwing\n      // an error if a conflict is detected.\n      const pub = getPublicIdentifiers(hash)\n      for (const otherHash of hashes) {\n        if (otherHash === hash) continue\n        const otherPub = getPublicIdentifiers(otherHash)\n        if (otherPub.typeName === pub.typeName) {\n          throw new Error(\n            `Conflicting type names for definitions #${hash} and #${otherHash} in ${this.doc.id}`,\n          )\n        }\n      }\n\n      // Try to keep and identifier that resembles the original hash as identifier\n      const safeIdentifier = asSafeDefinitionIdentifier(hash)\n\n      // If the safe identifier is not conflicting with other definition names,\n      // or reserved words, we can use it as-is. Otherwise, we need to generate\n      // a unique safe identifier.\n      const varName = safeIdentifier\n        ? !hashes.some((otherHash) => {\n            if (otherHash === hash) return false\n            const otherIdentifier = asSafeDefinitionIdentifier(otherHash)\n            return otherIdentifier === safeIdentifier\n          })\n          ? // Safe identifier can be used as-is as it does not conflict with\n            // other definition names\n            safeIdentifier\n          : // In order to keep identifiers stable, we use the safe identifier\n            // as base, and append a counter to avoid conflicts\n            this.nextSafeDefinitionIdentifier(safeIdentifier)\n        : // hash only contained unsafe characters, generate a safe one\n          this.nextSafeDefinitionIdentifier('def')\n\n      const typeName = ucFirst(varName)\n      assert(varName !== typeName, 'Variable and type name should be different')\n\n      return { varName, typeName }\n    },\n  )\n\n  /**\n   * @note Since this is a memoized function, and is used to generate the name\n   * of local variables, we should avoid returning different results for\n   * similar, but non strictly equal, inputs (eg. normalized / non-normalized).\n   * @see {@link resolve}\n   */\n  private readonly resolveExternal = memoize(\n    async (fullRef: string): Promise<ResolvedRef> => {\n      const [nsid, hash] = fullRef.split('#')\n      const moduleSpecifier = `${asRelativePath(\n        this.file.getDirectoryPath(),\n        join('/', ...nsid.split('.')),\n      )}.defs${this.options.importExt ?? '.js'}`\n\n      // Lets first make sure the referenced lexicon exists\n      const srcDoc = await this.indexer.get(nsid)\n      const srcDef = Object.hasOwn(srcDoc.defs, hash) ? srcDoc.defs[hash] : null\n      if (!srcDef) {\n        throw new Error(\n          `Missing def \"${hash}\" in \"${nsid}\" (referenced from ${this.doc.id})`,\n        )\n      }\n\n      // import * as <nsIdentifier> from './<moduleSpecifier>'\n      const nsIdentifier = this.getNsIdentifier(nsid, moduleSpecifier)\n\n      const publicIds = getPublicIdentifiers(hash)\n\n      return {\n        varName: isSafeIdentifier(publicIds.varName)\n          ? `${nsIdentifier}.${publicIds.varName}`\n          : `${nsIdentifier}[${JSON.stringify(publicIds.varName)}]`,\n        typeName: `${nsIdentifier}.${publicIds.typeName}`,\n      }\n    },\n  )\n\n  private getNsIdentifier(nsid: string, moduleSpecifier: string) {\n    const namespaceImportDeclaration =\n      this.file.getImportDeclaration(\n        (imp) =>\n          !imp.isTypeOnly() &&\n          imp.getModuleSpecifierValue() === moduleSpecifier &&\n          imp.getNamespaceImport() != null,\n      ) ||\n      this.file.addImportDeclaration({\n        moduleSpecifier,\n        namespaceImport: this.computeSafeNamespaceIdentifierFor(nsid),\n      })\n\n    return namespaceImportDeclaration.getNamespaceImport()!.getText()\n  }\n\n  #nsIdentifiersCounters = new Map<string, number>()\n  private computeSafeNamespaceIdentifierFor(nsid: string) {\n    const baseName = nsidToIdentifier(nsid) || 'NS'\n\n    let name = baseName\n    while (this.isConflictingIdentifier(name)) {\n      const count = this.#nsIdentifiersCounters.get(baseName) ?? 0\n      this.#nsIdentifiersCounters.set(baseName, count + 1)\n      name = `${baseName}$$${count}`\n    }\n\n    return name\n  }\n\n  private isConflictingIdentifier(name: string) {\n    return (\n      this.conflictsWithKeywords(name) ||\n      this.conflictsWithUtils(name) ||\n      this.conflictsWithLocalDefs(name) ||\n      this.conflictsWithLocalDeclarations(name) ||\n      this.conflictsWithImports(name)\n    )\n  }\n\n  private conflictsWithKeywords(name: string) {\n    return isReservedWord(name)\n  }\n\n  private conflictsWithUtils(name: string) {\n    // Do not allow \"Main\" as imported ns identifier since it has a special\n    // meaning in the context of lexicon definitions.\n    if (name === 'Main') return true\n\n    // When \"useRecordExport\" returns true, an export named \"Record\" will be\n    // used in addition to the hash named export. So we need to make sure both\n    // names are not conflicting with local variables.\n    if (name === 'Record') return true\n\n    // Utility functions generated for lexicon schemas are prefixed with \"$\"\n    return name.startsWith('$')\n  }\n\n  private conflictsWithLocalDefs(name: string) {\n    return Object.keys(this.doc.defs).some((hash) => {\n      const identifier = toCamelCase(hash)\n\n      // A safe identifier will be generated, no risk of conflict.\n      if (!identifier) return false\n\n      // The imported name conflicts with a local definition name\n      if (identifier === name || `_${identifier}` === name) return true\n\n      // The imported name conflicts with the type name of a local definition\n      const typeName = ucFirst(identifier)\n      if (typeName === name || `_${typeName}` === name) return true\n\n      return false\n    })\n  }\n\n  private conflictsWithLocalDeclarations(name: string) {\n    return (\n      this.file.getVariableDeclarations().some((v) => v.getName() === name) ||\n      this.file\n        .getVariableStatements()\n        .some((vs) => vs.getDeclarations().some((d) => d.getName() === name)) ||\n      this.file.getTypeAliases().some((t) => t.getName() === name) ||\n      this.file.getInterfaces().some((i) => i.getName() === name) ||\n      this.file.getClasses().some((c) => c.getName() === name) ||\n      this.file.getFunctions().some((f) => f.getName() === name) ||\n      this.file.getEnums().some((e) => e.getName() === name)\n    )\n  }\n\n  private conflictsWithImports(name: string) {\n    return this.file.getImportDeclarations().some(\n      (imp) =>\n        // import name from '...'\n        imp.getDefaultImport()?.getText() === name ||\n        // import * as name from '...'\n        imp.getNamespaceImport()?.getText() === name ||\n        imp.getNamedImports().some(\n          (named) =>\n            // import { name } from '...'\n            // import { foo as name } from '...'\n            (named.getAliasNode()?.getText() ?? named.getName()) === name,\n        ),\n    )\n  }\n}\n\n/**\n * @see {@link https://atproto.com/specs/nsid NSID syntax spec}\n */\nfunction nsidToIdentifier(nsid: string) {\n  const parts = nsid.split('.')\n\n  // By default, try to keep only to the last two segments of the NSID as\n  // contextual information. If those do not form a safe identifier (typically\n  // because they start with a digit), try with more segments until we reach the\n  // full NSID.\n  for (let i = 2; i < parts.length; i++) {\n    const identifier = toPascalCase(parts.slice(-i).join('.'))\n    if (isSafeIdentifier(identifier)) return identifier\n  }\n\n  return undefined\n}\n\n/**\n * Generates predictable public identifiers for a given definition hash.\n *\n * @note The returned `typeName` is guaranteed to be a valid TypeScript\n * identifier. `varName` may not be a valid identifier (eg. if the hash contains\n * unsafe characters), and may need to be accessed using string indexing.\n */\nexport function getPublicIdentifiers(hash: string): ResolvedRef {\n  const varName = hash\n  // @NOTE Type names *must* be valid TypeScript identifiers (this is because,\n  // unlike variable names, we cannot use string indexing to access exported\n  // types).\n  const typeName = toPascalCase(hash)\n  if (!typeName || varName === typeName || !isSafeIdentifier(typeName)) {\n    return { varName, typeName: `Def${typeName}` }\n  }\n  return { varName, typeName }\n}\n\nfunction asSafeDefinitionIdentifier(name: string) {\n  if (\n    startsWithLowerLetter(name) &&\n    isSafeIdentifier(name) &&\n    isSafeIdentifier(ucFirst(name))\n  ) {\n    return name\n  }\n  const camel = toCamelCase(name)\n  if (isSafeIdentifier(camel) && isSafeIdentifier(ucFirst(camel))) {\n    return camel\n  }\n  return undefined\n}\n"]}

package/dist/ts-lang.d.ts

@@ -1,3 +1,11 @@
+export declare function isJsKeyword(word: string): boolean;
+export declare function isGlobalIdentifier(word: string): boolean;
 export declare function isReservedWord(word: string): boolean;
-export declare function isSafeIdentifier(name: string): boolean;
+type SafeIdentifierOptions = {
+    /** Defaults to `false` */
+    allowGlobal?: boolean;
+};
+export declare function isSafeIdentifier(name: string, options?: SafeIdentifierOptions): boolean;
+export declare function asNamespaceExport(name: string): string;
+export {};
 //# sourceMappingURL=ts-lang.d.ts.map

package/dist/ts-lang.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ts-lang.d.ts","sourceRoot":"","sources":["../src/ts-lang.ts"],"names":[],"mappings":"AA+HA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,WAE1C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,WAE5C"}
+{"version":3,"file":"ts-lang.d.ts","sourceRoot":"","sources":["../src/ts-lang.ts"],"names":[],"mappings":"AA+EA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,WAEvC;AAwDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,WAO9C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,WAE1C;AAED,KAAK,qBAAqB,GAAG;IAC3B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,qBAAqB,WAOhC;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,UAI7C"}

package/dist/ts-lang.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJsKeyword = isJsKeyword;
+exports.isGlobalIdentifier = isGlobalIdentifier;
 exports.isReservedWord = isReservedWord;
 exports.isSafeIdentifier = isSafeIdentifier;
-const RESERVED_WORDS = new Set([
-    // JavaScript keywords
-    // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar
+exports.asNamespaceExport = asNamespaceExport;
+/**
+ * JavaScript keywords
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar}
+ */
+const JS_KEYWORDS = new Set([
     'abstract',
     'arguments',
     'as',
@@ -77,29 +82,20 @@ const RESERVED_WORDS = new Set([
     'while',
     'with',
     'yield',
-    // Constructors and globals
-    'Array',
-    'Boolean',
-    'Buffer',
-    'Date',
-    'Error',
-    'Function',
-    'Infinity',
-    'JSON',
-    'Map',
-    'Math',
-    'NaN',
-    'Number',
-    'Object',
-    'Set',
-    'String',
-    'Symbol',
-    'console',
-    'document',
-    'global',
-    'globalThis',
-    'window',
-    // Test globals
+]);
+function isJsKeyword(word) {
+    return JS_KEYWORDS.has(word);
+}
+const WELL_KNOWN_GLOBALS = new Set([
+    // ESM
+    'import',
+    // CommonJS
+    '__dirname',
+    '__filename',
+    'require',
+    'module',
+    'exports',
+    // Jest
     'afterAll',
     'afterEach',
     'assert',
@@ -109,30 +105,61 @@ const RESERVED_WORDS = new Set([
     'expect',
     'it',
     'test',
-    // CommonJS globals
-    '__dirname',
-    '__filename',
-    'require',
-    'module',
-    'exports',
-    // TypeScript
-    'Record',
+]);
+const TYPE_SCRIPT_GLOBALS = new Set([
+    // Primitives
     'any',
+    'bigint',
+    'boolean',
     'declare',
     'never',
+    'null',
     'number',
     'object',
     'string',
     'symbol',
+    'undefined',
     'unknown',
-    // Future reserved words
-    'constructor',
-    'meta',
+    'void',
+    // Utility types
+    'Record',
+    'Partial',
+    'Readonly',
+    'Pick',
+    'Omit',
+    'Exclude',
+    'Extract',
+    'InstanceType',
+    'ReturnType',
+    'Required',
+    'ThisType',
+    'Uppercase',
+    'Lowercase',
+    'Capitalize',
+    'Uncapitalize',
 ]);
+function isGlobalIdentifier(word) {
+    return (
+    // Should cover most common globals
+    word in globalThis ||
+        WELL_KNOWN_GLOBALS.has(word) ||
+        TYPE_SCRIPT_GLOBALS.has(word));
+}
 function isReservedWord(word) {
-    return RESERVED_WORDS.has(word);
+    return isJsKeyword(word) || isGlobalIdentifier(word);
+}
+function isSafeIdentifier(name, options) {
+    if (!options?.allowGlobal && isGlobalIdentifier(name)) {
+        return false;
+    }
+    return isValidJsIdentifier(name);
+}
+function isValidJsIdentifier(name) {
+    return !isJsKeyword(name) && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
 }
-function isSafeIdentifier(name) {
-    return !isReservedWord(name) && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+function asNamespaceExport(name) {
+    return isSafeIdentifier(name, { allowGlobal: true })
+        ? name
+        : JSON.stringify(name);
 }
 //# sourceMappingURL=ts-lang.js.map

package/dist/ts-lang.js.map

@@ -1 +1 @@
-{"version":3,"file":"ts-lang.js","sourceRoot":"","sources":["../src/ts-lang.ts"],"names":[],"mappings":";;AA+HA,wCAEC;AAED,4CAEC;AArID,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,sBAAsB;IACtB,oFAAoF;IACpF,UAAU;IACV,WAAW;IACX,IAAI;IACJ,OAAO;IACP,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;IACP,OAAO;IACP,SAAS;IACT,OAAO;IACP,KAAK;IACL,MAAM;IACN,UAAU;IACV,KAAK;IACL,MAAM;IACN,IAAI;IACJ,YAAY;IACZ,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,KAAK;IACL,WAAW;IACX,KAAK;IACL,MAAM;IACN,QAAQ;IACR,KAAK;IACL,MAAM;IACN,IAAI;IACJ,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,cAAc;IACd,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,MAAM;IACN,KAAK;IACL,QAAQ;IACR,WAAW;IACX,OAAO;IACP,KAAK;IACL,MAAM;IACN,UAAU;IACV,OAAO;IACP,MAAM;IACN,OAAO;IACP,2BAA2B;IAC3B,OAAO;IACP,SAAS;IACT,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,eAAe;IACf,UAAU;IACV,WAAW;IACX,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,mBAAmB;IACnB,WAAW;IACX,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,SAAS;IACT,aAAa;IACb,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,wBAAwB;IACxB,aAAa;IACb,MAAM;CACP,CAAC,CAAA;AACF,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzE,CAAC","sourcesContent":["const RESERVED_WORDS = new Set([\n  // JavaScript keywords\n  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar\n  'abstract',\n  'arguments',\n  'as',\n  'async',\n  'await',\n  'boolean',\n  'break',\n  'byte',\n  'case',\n  'catch',\n  'char',\n  'class',\n  'const',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'double',\n  'else',\n  'enum',\n  'eval',\n  'export',\n  'extends',\n  'false',\n  'final',\n  'finally',\n  'float',\n  'for',\n  'from',\n  'function',\n  'get',\n  'goto',\n  'if',\n  'implements',\n  'import',\n  'in',\n  'instanceof',\n  'int',\n  'interface',\n  'let',\n  'long',\n  'native',\n  'new',\n  'null',\n  'of',\n  'package',\n  'private',\n  'protected',\n  'public',\n  'return',\n  'set',\n  'short',\n  'static',\n  'super',\n  'switch',\n  'synchronized',\n  'this',\n  'throw',\n  'throws',\n  'transient',\n  'true',\n  'try',\n  'typeof',\n  'undefined',\n  'using',\n  'var',\n  'void',\n  'volatile',\n  'while',\n  'with',\n  'yield',\n  // Constructors and globals\n  'Array',\n  'Boolean',\n  'Buffer',\n  'Date',\n  'Error',\n  'Function',\n  'Infinity',\n  'JSON',\n  'Map',\n  'Math',\n  'NaN',\n  'Number',\n  'Object',\n  'Set',\n  'String',\n  'Symbol',\n  'console',\n  'document',\n  'global',\n  'globalThis',\n  'window',\n  // Test globals\n  'afterAll',\n  'afterEach',\n  'assert',\n  'beforeAll',\n  'beforeEach',\n  'describe',\n  'expect',\n  'it',\n  'test',\n  // CommonJS globals\n  '__dirname',\n  '__filename',\n  'require',\n  'module',\n  'exports',\n  // TypeScript\n  'Record',\n  'any',\n  'declare',\n  'never',\n  'number',\n  'object',\n  'string',\n  'symbol',\n  'unknown',\n  // Future reserved words\n  'constructor',\n  'meta',\n])\nexport function isReservedWord(word: string) {\n  return RESERVED_WORDS.has(word)\n}\n\nexport function isSafeIdentifier(name: string) {\n  return !isReservedWord(name) && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n"]}
+{"version":3,"file":"ts-lang.js","sourceRoot":"","sources":["../src/ts-lang.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * JavaScript keywords\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar}\n */\nconst JS_KEYWORDS = new Set([\n  'abstract',\n  'arguments',\n  'as',\n  'async',\n  'await',\n  'boolean',\n  'break',\n  'byte',\n  'case',\n  'catch',\n  'char',\n  'class',\n  'const',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'double',\n  'else',\n  'enum',\n  'eval',\n  'export',\n  'extends',\n  'false',\n  'final',\n  'finally',\n  'float',\n  'for',\n  'from',\n  'function',\n  'get',\n  'goto',\n  'if',\n  'implements',\n  'import',\n  'in',\n  'instanceof',\n  'int',\n  'interface',\n  'let',\n  'long',\n  'native',\n  'new',\n  'null',\n  'of',\n  'package',\n  'private',\n  'protected',\n  'public',\n  'return',\n  'set',\n  'short',\n  'static',\n  'super',\n  'switch',\n  'synchronized',\n  'this',\n  'throw',\n  'throws',\n  'transient',\n  'true',\n  'try',\n  'typeof',\n  'undefined',\n  'using',\n  'var',\n  'void',\n  'volatile',\n  'while',\n  'with',\n  'yield',\n])\n\nexport function isJsKeyword(word: string) {\n  return JS_KEYWORDS.has(word)\n}\n\nconst WELL_KNOWN_GLOBALS = new Set([\n  // ESM\n  'import',\n  // CommonJS\n  '__dirname',\n  '__filename',\n  'require',\n  'module',\n  'exports',\n  // Jest\n  'afterAll',\n  'afterEach',\n  'assert',\n  'beforeAll',\n  'beforeEach',\n  'describe',\n  'expect',\n  'it',\n  'test',\n])\n\nconst TYPE_SCRIPT_GLOBALS = new Set([\n  // Primitives\n  'any',\n  'bigint',\n  'boolean',\n  'declare',\n  'never',\n  'null',\n  'number',\n  'object',\n  'string',\n  'symbol',\n  'undefined',\n  'unknown',\n  'void',\n  // Utility types\n  'Record',\n  'Partial',\n  'Readonly',\n  'Pick',\n  'Omit',\n  'Exclude',\n  'Extract',\n  'InstanceType',\n  'ReturnType',\n  'Required',\n  'ThisType',\n  'Uppercase',\n  'Lowercase',\n  'Capitalize',\n  'Uncapitalize',\n])\n\nexport function isGlobalIdentifier(word: string) {\n  return (\n    // Should cover most common globals\n    word in globalThis ||\n    WELL_KNOWN_GLOBALS.has(word) ||\n    TYPE_SCRIPT_GLOBALS.has(word)\n  )\n}\n\nexport function isReservedWord(word: string) {\n  return isJsKeyword(word) || isGlobalIdentifier(word)\n}\n\ntype SafeIdentifierOptions = {\n  /** Defaults to `false` */\n  allowGlobal?: boolean\n}\n\nexport function isSafeIdentifier(\n  name: string,\n  options?: SafeIdentifierOptions,\n) {\n  if (!options?.allowGlobal && isGlobalIdentifier(name)) {\n    return false\n  }\n\n  return isValidJsIdentifier(name)\n}\n\nfunction isValidJsIdentifier(name: string) {\n  return !isJsKeyword(name) && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n\nexport function asNamespaceExport(name: string) {\n  return isSafeIdentifier(name, { allowGlobal: true })\n    ? name\n    : JSON.stringify(name)\n}\n"]}

package/dist/util.d.ts

@@ -1,4 +1,5 @@
 export declare function memoize<T extends (arg: string) => NonNullable<unknown> | null>(fn: T): T;
+export declare function startsWithLowerLetter(str: string): boolean;
 export declare function ucFirst(str: string): string;
 export declare function lcFirst(str: string): string;
 export declare function toPascalCase(str: string): string;

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,EAC5E,EAAE,EAAE,CAAC,GACJ,CAAC,CASH;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,UAElC;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,UAElC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAKtD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,WAG1C"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,EAC5E,EAAE,EAAE,CAAC,GACJ,CAAC,CASH;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,WAGhD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,UAElC;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,UAElC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAKtD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,WAG1C"}

package/dist/util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memoize = memoize;
+exports.startsWithLowerLetter = startsWithLowerLetter;
 exports.ucFirst = ucFirst;
 exports.lcFirst = lcFirst;
 exports.toPascalCase = toPascalCase;
@@ -22,6 +23,10 @@ function memoize(fn) {
         return result;
     });
 }
+function startsWithLowerLetter(str) {
+    const code = str.charCodeAt(0);
+    return code >= 97 && code <= 122; // 'a' to 'z'
+}
 function ucFirst(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
 }

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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","sourcesContent":["import { relative } from 'node:path'\n\nexport function memoize<T extends (arg: string) => NonNullable<unknown> | null>(\n  fn: T,\n): T {\n  const cache = new Map<string, NonNullable<unknown> | null>()\n  return ((arg: string) => {\n    const cached = cache.get(arg)\n    if (cached !== undefined) return cached\n    const result = fn(arg)\n    cache.set(arg, result)\n    return result\n  }) as T\n}\n\nexport function ucFirst(str: string) {\n  return str.charAt(0).toUpperCase() + str.slice(1)\n}\n\nexport function lcFirst(str: string) {\n  return str.charAt(0).toLowerCase() + str.slice(1)\n}\n\nexport function toPascalCase(str: string): string {\n  return extractWords(str).map(toLowerCase).map(ucFirst).join('')\n}\n\nexport function toCamelCase(str: string): string {\n  return lcFirst(toPascalCase(str))\n}\n\nexport function toConstantCase(str: string): string {\n  return extractWords(str).map(toUpperCase).join('_')\n}\n\nexport function toLowerCase(str: string): string {\n  return str.toLowerCase()\n}\n\nexport function toUpperCase(str: string): string {\n  return str.toUpperCase()\n}\n\nfunction extractWords(str: string): string[] {\n  const processedStr = str\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2') // split camelCase\n    .replace(/([A-Z])([A-Z][a-z])/g, '$1 $2') // split ALLCAPSWords\n    .replace(/([0-9])([A-Za-z])/g, '$1 $2') // split number followed by letter\n    .replace(/[^a-zA-Z0-9]+/g, ' ') // replace non-alphanumeric with space\n    .trim() // trim leading/trailing spaces\n\n  return processedStr\n    ? processedStr.split(/\\s+/) // split by spaces\n    : [] // Avoid returning [''] for empty strings\n}\n\nexport function asRelativePath(from: string, to: string) {\n  const relPath = relative(from, to)\n  return relPath.startsWith('./') || relPath.startsWith('../')\n    ? relPath\n    : `./${relPath}`\n}\n\nexport function startsWithDigit(str: string) {\n  const code = str.charCodeAt(0)\n  return code >= 48 && code <= 57 // '0' to '9'\n}\n"]}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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","sourcesContent":["import { relative } from 'node:path'\n\nexport function memoize<T extends (arg: string) => NonNullable<unknown> | null>(\n  fn: T,\n): T {\n  const cache = new Map<string, NonNullable<unknown> | null>()\n  return ((arg: string) => {\n    const cached = cache.get(arg)\n    if (cached !== undefined) return cached\n    const result = fn(arg)\n    cache.set(arg, result)\n    return result\n  }) as T\n}\n\nexport function startsWithLowerLetter(str: string) {\n  const code = str.charCodeAt(0)\n  return code >= 97 && code <= 122 // 'a' to 'z'\n}\n\nexport function ucFirst(str: string) {\n  return str.charAt(0).toUpperCase() + str.slice(1)\n}\n\nexport function lcFirst(str: string) {\n  return str.charAt(0).toLowerCase() + str.slice(1)\n}\n\nexport function toPascalCase(str: string): string {\n  return extractWords(str).map(toLowerCase).map(ucFirst).join('')\n}\n\nexport function toCamelCase(str: string): string {\n  return lcFirst(toPascalCase(str))\n}\n\nexport function toConstantCase(str: string): string {\n  return extractWords(str).map(toUpperCase).join('_')\n}\n\nexport function toLowerCase(str: string): string {\n  return str.toLowerCase()\n}\n\nexport function toUpperCase(str: string): string {\n  return str.toUpperCase()\n}\n\nfunction extractWords(str: string): string[] {\n  const processedStr = str\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2') // split camelCase\n    .replace(/([A-Z])([A-Z][a-z])/g, '$1 $2') // split ALLCAPSWords\n    .replace(/([0-9])([A-Za-z])/g, '$1 $2') // split number followed by letter\n    .replace(/[^a-zA-Z0-9]+/g, ' ') // replace non-alphanumeric with space\n    .trim() // trim leading/trailing spaces\n\n  return processedStr\n    ? processedStr.split(/\\s+/) // split by spaces\n    : [] // Avoid returning [''] for empty strings\n}\n\nexport function asRelativePath(from: string, to: string) {\n  const relPath = relative(from, to)\n  return relPath.startsWith('./') || relPath.startsWith('../')\n    ? relPath\n    : `./${relPath}`\n}\n\nexport function startsWithDigit(str: string) {\n  const code = str.charCodeAt(0)\n  return code >= 48 && code <= 57 // '0' to '9'\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/lex-builder",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "license": "MIT",
   "description": "TypeScript schema builder for AT Lexicons",
   "keywords": [
@@ -39,8 +39,8 @@
     "prettier": "^3.2.5",
     "ts-morph": "^27.0.0",
     "tslib": "^2.8.1",
-    "@atproto/lex-document": "0.0.7",
-    "@atproto/lex-schema": "0.0.6"
+    "@atproto/lex-document": "0.0.8",
+    "@atproto/lex-schema": "0.0.7"
   },
   "devDependencies": {
     "@ts-morph/common": "^0.28.0",

package/src/lex-builder.ts

@@ -1,3 +1,4 @@
+import assert from 'node:assert'
 import { mkdir, rm, stat, writeFile } from 'node:fs/promises'
 import { join, resolve } from 'node:path'
 import { IndentationText, Project } from 'ts-morph'
@@ -10,9 +11,17 @@ import {
   LexiconDirectoryIndexer,
   LexiconDirectoryIndexerOptions,
 } from './lexicon-directory-indexer.js'
-import { isSafeIdentifier } from './ts-lang.js'
+import { asNamespaceExport } from './ts-lang.js'
 
 export type LexBuilderOptions = LexDefBuilderOptions & {
+  /**
+   * Whether to generate an index file at the root exporting all top-level
+   * namespaces.
+   *
+   * @note This could theoretically cause name conflicts if a
+   * @default false
+   */
+  indexFile?: boolean
   importExt?: string
   fileExt?: string
 }
@@ -100,6 +109,23 @@ export class LexBuilder {
   private async createExportTree(doc: LexiconDocument) {
     const namespaces = doc.id.split('.')
 
+    if (this.options.indexFile) {
+      const indexFile = this.getFile(`/index${this.fileExt}`)
+
+      const tldNs = namespaces[0]!
+      assert(
+        tldNs !== 'index',
+        'The "indexFile" options cannot be used with namespaces using a ".index" tld.',
+      )
+      const tldNsSpecifier = `./${tldNs}${this.importExt}`
+      if (!indexFile.getExportDeclaration(tldNsSpecifier)) {
+        indexFile.addExportDeclaration({
+          moduleSpecifier: tldNsSpecifier,
+          namespaceExport: asNamespaceExport(tldNs),
+        })
+      }
+    }
+
     // First create the parent namespaces
     for (let i = 0; i < namespaces.length - 1; i++) {
       const currentNs = namespaces[i]
@@ -113,9 +139,7 @@ export class LexBuilder {
       if (!dec) {
         file.addExportDeclaration({
           moduleSpecifier: childModuleSpecifier,
-          namespaceExport: isSafeIdentifier(childNs)
-            ? childNs
-            : JSON.stringify(childNs),
+          namespaceExport: asNamespaceExport(childNs),
         })
       }
     }

package/src/ref-resolver.ts

@@ -6,6 +6,7 @@ import { isReservedWord, isSafeIdentifier } from './ts-lang.js'
 import {
   asRelativePath,
   memoize,
+  startsWithLowerLetter,
   toCamelCase,
   toPascalCase,
   ucFirst,
@@ -299,8 +300,16 @@ export function getPublicIdentifiers(hash: string): ResolvedRef {
 }
 
 function asSafeDefinitionIdentifier(name: string) {
-  if (isSafeIdentifier(name) && isSafeIdentifier(ucFirst(name))) return name
+  if (
+    startsWithLowerLetter(name) &&
+    isSafeIdentifier(name) &&
+    isSafeIdentifier(ucFirst(name))
+  ) {
+    return name
+  }
   const camel = toCamelCase(name)
-  if (isSafeIdentifier(camel) && isSafeIdentifier(ucFirst(camel))) return camel
+  if (isSafeIdentifier(camel) && isSafeIdentifier(ucFirst(camel))) {
+    return camel
+  }
   return undefined
 }

package/src/ts-lang.ts

@@ -1,6 +1,8 @@
-const RESERVED_WORDS = new Set([
-  // JavaScript keywords
-  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar
+/**
+ * JavaScript keywords
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar}
+ */
+const JS_KEYWORDS = new Set([
   'abstract',
   'arguments',
   'as',
@@ -73,29 +75,22 @@ const RESERVED_WORDS = new Set([
   'while',
   'with',
   'yield',
-  // Constructors and globals
-  'Array',
-  'Boolean',
-  'Buffer',
-  'Date',
-  'Error',
-  'Function',
-  'Infinity',
-  'JSON',
-  'Map',
-  'Math',
-  'NaN',
-  'Number',
-  'Object',
-  'Set',
-  'String',
-  'Symbol',
-  'console',
-  'document',
-  'global',
-  'globalThis',
-  'window',
-  // Test globals
+])
+
+export function isJsKeyword(word: string) {
+  return JS_KEYWORDS.has(word)
+}
+
+const WELL_KNOWN_GLOBALS = new Set([
+  // ESM
+  'import',
+  // CommonJS
+  '__dirname',
+  '__filename',
+  'require',
+  'module',
+  'exports',
+  // Jest
   'afterAll',
   'afterEach',
   'assert',
@@ -105,30 +100,76 @@ const RESERVED_WORDS = new Set([
   'expect',
   'it',
   'test',
-  // CommonJS globals
-  '__dirname',
-  '__filename',
-  'require',
-  'module',
-  'exports',
-  // TypeScript
-  'Record',
+])
+
+const TYPE_SCRIPT_GLOBALS = new Set([
+  // Primitives
   'any',
+  'bigint',
+  'boolean',
   'declare',
   'never',
+  'null',
   'number',
   'object',
   'string',
   'symbol',
+  'undefined',
   'unknown',
-  // Future reserved words
-  'constructor',
-  'meta',
+  'void',
+  // Utility types
+  'Record',
+  'Partial',
+  'Readonly',
+  'Pick',
+  'Omit',
+  'Exclude',
+  'Extract',
+  'InstanceType',
+  'ReturnType',
+  'Required',
+  'ThisType',
+  'Uppercase',
+  'Lowercase',
+  'Capitalize',
+  'Uncapitalize',
 ])
+
+export function isGlobalIdentifier(word: string) {
+  return (
+    // Should cover most common globals
+    word in globalThis ||
+    WELL_KNOWN_GLOBALS.has(word) ||
+    TYPE_SCRIPT_GLOBALS.has(word)
+  )
+}
+
 export function isReservedWord(word: string) {
-  return RESERVED_WORDS.has(word)
+  return isJsKeyword(word) || isGlobalIdentifier(word)
+}
+
+type SafeIdentifierOptions = {
+  /** Defaults to `false` */
+  allowGlobal?: boolean
+}
+
+export function isSafeIdentifier(
+  name: string,
+  options?: SafeIdentifierOptions,
+) {
+  if (!options?.allowGlobal && isGlobalIdentifier(name)) {
+    return false
+  }
+
+  return isValidJsIdentifier(name)
+}
+
+function isValidJsIdentifier(name: string) {
+  return !isJsKeyword(name) && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)
 }
 
-export function isSafeIdentifier(name: string) {
-  return !isReservedWord(name) && /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)
+export function asNamespaceExport(name: string) {
+  return isSafeIdentifier(name, { allowGlobal: true })
+    ? name
+    : JSON.stringify(name)
 }

package/src/util.ts

@@ -13,6 +13,11 @@ export function memoize<T extends (arg: string) => NonNullable<unknown> | null>(
   }) as T
 }
 
+export function startsWithLowerLetter(str: string) {
+  const code = str.charCodeAt(0)
+  return code >= 97 && code <= 122 // 'a' to 'z'
+}
+
 export function ucFirst(str: string) {
   return str.charAt(0).toUpperCase() + str.slice(1)
 }