@hey-api/codegen-core 0.0.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Hey API
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+<div align="center">
+  <img alt="Three people building a brick structure" height="214" src="https://heyapi.dev/images/bricks-640w.png" width="320">
+  <h1 align="center"><b>Codegen Core</b></h1>
+  <p align="center">🧱 TypeScript framework for generating structured, multi-file source code from abstract syntax trees.</p>
+</div>
+
+<br/>
+
+<p align="center">
+  <a href="https://opensource.org/license/mit" rel="nofollow"><img src="https://img.shields.io/github/license/hey-api/openapi-ts" alt="MIT License"></a>
+  <a href="https://github.com/hey-api/openapi-ts/actions?query=branch%3Amain"><img src="https://github.com/hey-api/openapi-ts/actions/workflows/ci.yml/badge.svg?event=push&branch=main" alt="CI status" /></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/hey-api/openapi-ts/issues">Issues</a>
+  <span>&nbsp;•&nbsp;</span>
+  <a href="https://heyapi.dev/openapi-ts/community/contributing">Contribute</a>
+  <span>&nbsp;•&nbsp;</span>
+  <a href="https://heyapi.dev/openapi-ts/community/spotlight#core-team">Join Core Team</a>
+</p>
+
+<br/>
+
+## Dashboard
+
+Hey API is an ecosystem of products helping you build better APIs. Superpower your codegen and APIs with Hey API Platform.
+
+[Sign In](https://app.heyapi.dev) to Hey API Platform.
+
+## Contributing
+
+Want to see your code in products used by millions?
+
+Start with our [Contributing](https://heyapi.dev/openapi-ts/community/contributing) guide and release your first feature.
+
+## Sponsors
+
+Help Hey API stay around for the long haul by becoming a [sponsor](https://github.com/sponsors/hey-api).
+
+<h3 align="center">Gold</h3>
+
+<table align="center" style="justify-content: center;align-items: center;display: flex;">
+  <tbody>
+    <tr>
+      <td align="center">
+        <p></p>
+        <p>
+          <a href="https://kutt.it/pkEZyc" target="_blank">
+            <picture height="50px">
+              <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/images/stainless-logo-wordmark-480w.jpeg">
+              <img alt="Stainless logo" height="50px" src="https://heyapi.dev/images/stainless-logo-wordmark-480w.jpeg">
+            </picture>
+          </a>
+          <br/>
+          Best-in-class SDKs and MCP for your API.
+          <br/>
+          <a href="https://kutt.it/pkEZyc" style="text-decoration:none;" target="_blank">
+            stainless.com
+          </a>
+        </p>
+        <p></p>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+<h3 align="center">Silver</h3>
+
+<table align="center" style="justify-content: center;align-items: center;display: flex;">
+  <tbody>
+    <tr>
+      <td align="center">
+        <a href="https://kutt.it/skQUVd" target="_blank">
+          <picture height="40px">
+            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/images/scalar-logo-wordmark-480w.jpeg">
+            <img alt="Scalar logo" height="40px" src="https://heyapi.dev/scalar-logo-wordmark.svg">
+          </picture>
+        </a>
+        <br/>
+        <a href="https://kutt.it/skQUVd" style="text-decoration:none;" target="_blank">
+          scalar.com
+        </a>
+      </td>
+      <td align="center">
+        <a href="https://kutt.it/Dr9GuW" target="_blank">
+          <picture height="40px">
+            <img alt="FastAPI logo" height="40px" src="https://heyapi.dev/fastapi-logo-wordmark.svg">
+          </picture>
+        </a>
+        <br/>
+        <a href="https://kutt.it/Dr9GuW" style="text-decoration:none;" target="_blank">
+          fastapi.tiangolo.com
+        </a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+<h3 align="center">Bronze</h3>
+
+<table align="center" style="justify-content: center;align-items: center;display: flex;">
+  <tbody>
+    <tr>
+      <td align="center">
+        <a href="https://kutt.it/YpaKsX" target="_blank">
+          <picture height="34px">
+            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/images/kinde-logo-wordmark-dark-480w.webp">
+            <img alt="Kinde logo" height="34px" src="https://heyapi.dev/images/kinde-logo-wordmark-480w.jpeg">
+          </picture>
+        </a>
+      </td>
+      <td align="center">
+        <a href="https://kutt.it/KkqSaw" target="_blank">
+          <picture height="34px">
+            <source media="(prefers-color-scheme: dark)" srcset="https://heyapi.dev/images/cella-logo-wordmark-480w.webp">
+            <img alt="Cella logo" height="34px" src="https://heyapi.dev/cella-logo-wordmark.svg">
+          </picture>
+        </a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+## License
+
+Released under the [MIT License](https://github.com/hey-api/openapi-ts/blob/main/LICENSE.md).

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var s=require('path');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var s__default=/*#__PURE__*/_interopDefault(s);var i=class d{constructor(e,t={}){this.path=e;this.meta=t;let r=d.pathToFilePath(e);t.path&&(typeof t.path=="function"?r=t.path(r):r=t.path.replace("{{path}}",r)),this.path=r;}cache={};state={exports:new Map,imports:new Map,symbols:new Map};addExport(e){return this.addImportExport(e,"exports")}addImport(e){return this.addImportExport(e,"imports")}addImportExport(e,t){let r=typeof e.from=="string"?e.from:e.from.path,o=this.state[t].get(r);o?(this.mergeImportExportValues(o,e),this.state[t].set(r,o)):this.state[t].set(r,{...e}),this.cache[t]=void 0;}addSymbol(e){let t=e.name,r=this.state.symbols.get(t);r?(r.value=e.value,this.state.symbols.set(t,r)):this.state.symbols.set(t,{...e}),this.cache.symbols=void 0;}get exports(){return this.cache.exports||(this.cache.exports=Array.from(this.state.exports.values())),this.cache.exports}getAllSymbols(){return [...this.symbols,...this.imports.flatMap(e=>(e.names??[]).map(t=>({name:e.aliases?.[t]??t}))),...this.exports.flatMap(e=>(e.names??[]).map(t=>({name:e.aliases?.[t]??t})))]}hasContent(){return this.state.symbols.size>0||this.state.exports.size>0}hasSymbol(e){return this.state.symbols.has(e)}get imports(){return this.cache.imports||(this.cache.imports=Array.from(this.state.imports.values())),this.cache.imports}mergeImportExportValues(e,t){e.aliases={...e.aliases,...t.aliases},t.defaultImport!==void 0&&(e.defaultImport=t.defaultImport),e.names=[...new Set([...e.names??[],...t.names??[]])],t.namespaceImport!==void 0&&(e.namespaceImport=t.namespaceImport),t.typeDefaultImport!==void 0&&(e.typeDefaultImport=t.typeDefaultImport),e.typeNames=[...new Set([...e.typeNames??[],...t.typeNames??[]])],t.typeNamespaceImport!==void 0&&(e.typeNamespaceImport=t.typeNamespaceImport);}static pathToFilePath(e){return e.includes("/")?e.split("/").filter(Boolean).join(s__default.default.sep):e.includes("\\")?e.split("\\").filter(Boolean).join(s__default.default.sep):e.split(s__default.default.sep).filter(Boolean).join(s__default.default.sep)}relativePathFromFile(e){let t=s__default.default.posix.relative(s__default.default.posix.dirname(e.path),this.path);return t.startsWith(".")||(t=`./${t}`),t}relativePathToFile(e){let t=s__default.default.posix.relative(s__default.default.posix.dirname(this.path),e.path);return t.startsWith(".")||(t=`./${t}`),t}get symbols(){return this.cache.symbols||(this.cache.symbols=Array.from(this.state.symbols.values())),this.cache.symbols}};var a=class{filesMap=new Map;filesOrder=[];renderers=new Map;addExportToFile(e,t){this.ensureFile(e).addExport(t);}addImportToFile(e,t){this.ensureFile(e).addImport(t);}addSymbolToFile(e,t){this.ensureFile(e).addSymbol(t);}createFile(e,t={}){let{renderer:r,...o}=t;r&&this.ensureRenderer(r);let n=this.getFileByPath(e);if(n)return r?.id&&r.id!==n.meta.renderer&&(n.meta.renderer=r.id),n;let p=new i(e,{...o,renderer:r?.id});return this.filesOrder.push(p),this.filesMap.set(e,p),p}ensureFile(e){if(typeof e!="string")return e;let t=this.getFileByPath(e);return t||this.createFile(e)}ensureRenderer(e){return this.renderers.has(e.id)||this.renderers.set(e.id,e),this.renderers.get(e.id)}get files(){return [...this.filesOrder]}getAllSymbols(){return this.filesOrder.flatMap(e=>e.getAllSymbols())}getFileByPath(e){return this.filesMap.get(e)}render(e){let t=[];for(let r of this.filesOrder){if(!r.meta.renderer)continue;let o=this.renderers.get(r.meta.renderer);o&&t.push(o.render(r,e));}return t}};exports.CodegenFile=i;exports.CodegenProject=a;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/files/file.ts","../src/project/project.ts"],"names":["CodegenFile","_CodegenFile","path","meta","filePath","exp","imp","value","field","key","existing","symbol","name","target","source","file","relativePath","CodegenProject","fileOrPath","renderer","metadata","existingFile","results"],"mappings":"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","file":"index.cjs","sourcesContent":["import path from 'node:path';\n\nimport type { ICodegenImport } from '../imports/types';\nimport type { ICodegenSymbol } from '../symbols/types';\nimport type { ICodegenFile } from './types';\n\nexport class CodegenFile implements ICodegenFile {\n  private cache: {\n    exports?: ReadonlyArray<ICodegenImport>;\n    imports?: ReadonlyArray<ICodegenImport>;\n    symbols?: ReadonlyArray<ICodegenSymbol>;\n  } = {};\n\n  private state: {\n    exports: Map<string, ICodegenImport>;\n    imports: Map<string, ICodegenImport>;\n    symbols: Map<string, ICodegenSymbol>;\n  } = {\n    exports: new Map(),\n    imports: new Map(),\n    symbols: new Map(),\n  };\n\n  constructor(\n    public path: string,\n    public meta: ICodegenFile['meta'] = {},\n  ) {\n    let filePath = CodegenFile.pathToFilePath(path);\n    if (meta.path) {\n      if (typeof meta.path === 'function') {\n        filePath = meta.path(filePath);\n      } else {\n        filePath = meta.path.replace('{{path}}', filePath);\n      }\n    }\n    this.path = filePath;\n  }\n\n  addExport(exp: ICodegenImport): void {\n    return this.addImportExport(exp, 'exports');\n  }\n\n  addImport(imp: ICodegenImport): void {\n    return this.addImportExport(imp, 'imports');\n  }\n\n  private addImportExport(\n    value: ICodegenImport,\n    field: 'exports' | 'imports',\n  ): void {\n    const key = typeof value.from === 'string' ? value.from : value.from.path;\n    const existing = this.state[field].get(key);\n    if (existing) {\n      this.mergeImportExportValues(existing, value);\n      this.state[field].set(key, existing);\n    } else {\n      this.state[field].set(key, { ...value }); // clone to avoid mutation\n    }\n    this.cache[field] = undefined;\n  }\n\n  addSymbol(symbol: ICodegenSymbol): void {\n    const key = symbol.name;\n    const existing = this.state.symbols.get(key);\n    if (existing) {\n      existing.value = symbol.value;\n      this.state.symbols.set(key, existing);\n    } else {\n      this.state.symbols.set(key, { ...symbol }); // clone to avoid mutation\n    }\n    this.cache.symbols = undefined;\n  }\n\n  get exports(): ReadonlyArray<ICodegenImport> {\n    if (!this.cache.exports) {\n      this.cache.exports = Array.from(this.state.exports.values());\n    }\n    return this.cache.exports;\n  }\n\n  getAllSymbols(): ReadonlyArray<ICodegenSymbol> {\n    return [\n      ...this.symbols,\n      ...this.imports.flatMap((imp) =>\n        (imp.names ?? []).map((name) => ({\n          name: imp.aliases?.[name] ?? name,\n        })),\n      ),\n      ...this.exports.flatMap((imp) =>\n        (imp.names ?? []).map((name) => ({\n          name: imp.aliases?.[name] ?? name,\n        })),\n      ),\n    ];\n  }\n\n  hasContent(): boolean {\n    return this.state.symbols.size > 0 || this.state.exports.size > 0;\n  }\n\n  hasSymbol(name: string): boolean {\n    return this.state.symbols.has(name);\n  }\n\n  get imports(): ReadonlyArray<ICodegenImport> {\n    if (!this.cache.imports) {\n      this.cache.imports = Array.from(this.state.imports.values());\n    }\n    return this.cache.imports;\n  }\n\n  private mergeImportExportValues(\n    target: ICodegenImport,\n    source: ICodegenImport,\n  ): void {\n    target.aliases = { ...target.aliases, ...source.aliases };\n    if (source.defaultImport !== undefined) {\n      target.defaultImport = source.defaultImport;\n    }\n    target.names = [\n      ...new Set([...(target.names ?? []), ...(source.names ?? [])]),\n    ];\n    if (source.namespaceImport !== undefined) {\n      target.namespaceImport = source.namespaceImport;\n    }\n    if (source.typeDefaultImport !== undefined) {\n      target.typeDefaultImport = source.typeDefaultImport;\n    }\n    target.typeNames = [\n      ...new Set([...(target.typeNames ?? []), ...(source.typeNames ?? [])]),\n    ];\n    if (source.typeNamespaceImport !== undefined) {\n      target.typeNamespaceImport = source.typeNamespaceImport;\n    }\n  }\n\n  static pathToFilePath(source: string): string {\n    if (source.includes('/')) {\n      return source.split('/').filter(Boolean).join(path.sep);\n    }\n    if (source.includes('\\\\')) {\n      return source.split('\\\\').filter(Boolean).join(path.sep);\n    }\n    return source.split(path.sep).filter(Boolean).join(path.sep);\n  }\n\n  relativePathFromFile(file: Pick<ICodegenFile, 'path'>): string {\n    let relativePath = path.posix.relative(\n      path.posix.dirname(file.path),\n      this.path,\n    );\n    if (!relativePath.startsWith('.')) {\n      relativePath = `./${relativePath}`;\n    }\n    return relativePath;\n  }\n\n  relativePathToFile(file: Pick<ICodegenFile, 'path'>): string {\n    let relativePath = path.posix.relative(\n      path.posix.dirname(this.path),\n      file.path,\n    );\n    if (!relativePath.startsWith('.')) {\n      relativePath = `./${relativePath}`;\n    }\n    return relativePath;\n  }\n\n  get symbols(): ReadonlyArray<ICodegenSymbol> {\n    if (!this.cache.symbols) {\n      this.cache.symbols = Array.from(this.state.symbols.values());\n    }\n    return this.cache.symbols;\n  }\n}\n","import { CodegenFile } from '../files/file';\nimport type { ICodegenImport } from '../imports/types';\nimport type { ICodegenMeta } from '../meta/types';\nimport type { ICodegenOutput } from '../output/types';\nimport type { ICodegenRenderer } from '../renderers/types';\nimport type { ICodegenSymbol } from '../symbols/types';\nimport type { ICodegenProject } from './types';\n\nexport class CodegenProject implements ICodegenProject {\n  private filesMap: Map<string, CodegenFile> = new Map();\n  private filesOrder: Array<CodegenFile> = [];\n  private renderers: Map<string, ICodegenRenderer> = new Map();\n\n  addExportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void {\n    const file = this.ensureFile(fileOrPath);\n    file.addExport(imp);\n  }\n\n  addImportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void {\n    const file = this.ensureFile(fileOrPath);\n    file.addImport(imp);\n  }\n\n  addSymbolToFile(\n    fileOrPath: CodegenFile | string,\n    symbol: ICodegenSymbol,\n  ): void {\n    const file = this.ensureFile(fileOrPath);\n    file.addSymbol(symbol);\n  }\n\n  createFile(\n    path: string,\n    meta: Omit<CodegenFile['meta'], 'renderer'> & {\n      /**\n       * Renderer to use to render this file.\n       */\n      renderer?: ICodegenRenderer;\n    } = {},\n  ): CodegenFile {\n    const { renderer, ...metadata } = meta;\n    if (renderer) {\n      this.ensureRenderer(renderer);\n    }\n\n    const existing = this.getFileByPath(path);\n    if (existing) {\n      // Whoever is creating the file will override the renderer\n      if (renderer?.id && renderer.id !== existing.meta.renderer) {\n        existing.meta.renderer = renderer.id;\n      }\n      return existing;\n    }\n\n    const file = new CodegenFile(path, {\n      ...metadata,\n      renderer: renderer?.id,\n    });\n    this.filesOrder.push(file);\n    this.filesMap.set(path, file);\n    return file;\n  }\n\n  ensureFile(fileOrPath: CodegenFile | string): CodegenFile {\n    if (typeof fileOrPath !== 'string') {\n      return fileOrPath;\n    }\n    const existingFile = this.getFileByPath(fileOrPath);\n    if (existingFile) {\n      return existingFile;\n    }\n    return this.createFile(fileOrPath);\n  }\n\n  private ensureRenderer(renderer: ICodegenRenderer): ICodegenRenderer {\n    if (!this.renderers.has(renderer.id)) {\n      this.renderers.set(renderer.id, renderer);\n    }\n    return this.renderers.get(renderer.id)!;\n  }\n\n  get files(): ReadonlyArray<CodegenFile> {\n    return [...this.filesOrder];\n  }\n\n  getAllSymbols(): ReadonlyArray<ICodegenSymbol> {\n    return this.filesOrder.flatMap((file) => file.getAllSymbols());\n  }\n\n  getFileByPath(path: string): CodegenFile | undefined {\n    return this.filesMap.get(path);\n  }\n\n  render(meta?: ICodegenMeta): ReadonlyArray<ICodegenOutput> {\n    const results: Array<ICodegenOutput> = [];\n    for (const file of this.filesOrder) {\n      if (!file.meta.renderer) continue;\n      const renderer = this.renderers.get(file.meta.renderer);\n      if (!renderer) continue;\n      results.push(renderer.render(file, meta));\n    }\n    return results;\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,391 @@
+/**
+ * Arbitrary metadata passed to render functions.
+ *
+ * Implementors should extend this interface for their own needs.
+ */
+interface ICodegenMeta {
+  [key: string]: unknown;
+}
+
+interface ICodegenOutput {
+  /**
+   * The main content of the file to output.
+   *
+   * A raw string representing source code.
+   *
+   * @example "function foo(): void {\n  // implementation\n}\n"
+   */
+  content: string;
+  /**
+   * Optional metadata or hints for the emitter, such as formatting options,
+   * source maps, or language-specific flags.
+   *
+   * @example { format: "prettier", sourceMap: true }
+   */
+  meta: Record<string, unknown>;
+  /**
+   * Logical output path (used for writing the file).
+   *
+   * @example "models/user.ts"
+   */
+  path: string;
+}
+
+interface ICodegenRenderer {
+  /**
+   * Optional: hook for renderer-level setup logic (e.g., formatting, config)
+   */
+  configure?(options: Record<string, unknown>): void;
+  /**
+   * Unique identifier for this renderer.
+   *
+   * @example "typescript"
+   */
+  id: string;
+  /**
+   * Returns printable data.
+   *
+   * @param file The file to render.
+   * @param meta Arbitrary metadata.
+   * @returns Output for file emit step
+   */
+  render(file: CodegenFile, meta?: ICodegenMeta): ICodegenOutput;
+}
+
+interface ICodegenSymbol {
+  /**
+   * Optional description or doc comment.
+   *
+   * @example "Represents a user in the system"
+   */
+  description?: string;
+  /**
+   * Optional kind of symbol (e.g. "class", "function", "type", etc.).
+   *
+   * @example "class"
+   */
+  kind?: string;
+  /**
+   * Unique identifier for the symbol within its file.
+   *
+   * @example "UserModel"
+   */
+  name: string;
+  /**
+   * Internal representation of the symbol (e.g. AST node, IR object, raw
+   * code). Used to generate output.
+   */
+  value?: unknown;
+}
+
+interface ICodegenFile {
+  /**
+   * Adds an export to this file.
+   *
+   * This is also known as a re-export.
+   *
+   * @param exp The export to add
+   */
+  addExport(exp: ICodegenImport): void;
+  /**
+   * Adds an import to this file.
+   *
+   * @param imp The import to add
+   */
+  addImport(imp: ICodegenImport): void;
+  /**
+   * Adds a symbol defined by this file.
+   *
+   * @param symbol The symbol to add
+   */
+  addSymbol(symbol: ICodegenSymbol): void;
+  /**
+   * Symbols exported from other files.
+   **/
+  exports: ReadonlyArray<ICodegenImport>;
+  /**
+   * Returns all symbols used in this file (declared + imported).
+   *
+   * @returns List of all symbols used in this file
+   */
+  getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+  /**
+   * Checks if this file contains any content.
+   *
+   * This is used to determine whether we want to process the file further.
+   * By default, we consider only symbols and exports as content.
+   *
+   * @returns True if the file contains content
+   */
+  hasContent(): boolean;
+  /**
+   * Checks if this file defines a symbol with the given name.
+   *
+   * @param name Symbol name to check
+   * @returns True if the symbol is defined by this file
+   */
+  hasSymbol(name: string): boolean;
+  /**
+   * Symbols imported from other files.
+   **/
+  imports: ReadonlyArray<ICodegenImport>;
+  /**
+   * Optional metadata about the file.
+   **/
+  meta: {
+    /**
+     * Optional file extension.
+     *
+     * @example ".ts"
+     */
+    extension?: '.ts' | (string & {});
+    /**
+     * Optional logical module or package name.
+     *
+     * @example "models.user"
+     */
+    moduleName?: string;
+    /**
+     * Optional path transformer.
+     *
+     * @param path Original file path passed to the constructor.
+     */
+    path?: ((path: string) => string) | string;
+    /**
+     * Renderer ID.
+     *
+     * @example "typescript"
+     */
+    renderer?: ICodegenRenderer['id'];
+  };
+  /**
+   * Logical output path (used for writing the file).
+   *
+   * @example "models/user.ts"
+   */
+  path: string;
+  /**
+   * Returns a relative path to this file from another file.
+   *
+   * @param file The file from which we want the relative path to this file.
+   * @example "./this-file.ts"
+   */
+  relativePathFromFile(file: Pick<ICodegenFile, 'path'>): string;
+  /**
+   * Returns a relative path to file from this file.
+   *
+   * @param file The file to which we want the relative path.
+   * @example "./another-file.ts"
+   */
+  relativePathToFile(file: Pick<ICodegenFile, 'path'>): string;
+  /**
+   * Top-level symbols declared in this file.
+   **/
+  symbols: ReadonlyArray<ICodegenSymbol>;
+}
+
+interface ICodegenImport {
+  /**
+   * Optional aliasing map for imported symbols.
+   *
+   * Keys must be a subset of `names`, values are aliases.
+   *
+   * @example { User: "ImportedUser" }
+   */
+  aliases?: Record<string, string>;
+  /**
+   * Name of the default import, if any.
+   *
+   * @example "React"
+   */
+  defaultImport?: string;
+  /**
+   * Source file or external module from which symbols are imported.
+   *
+   * For internal files, this should be a ICodegenFile instance to enable
+   * dynamic path computation. For external or system modules, use a string.
+   *
+   * @example "./models/user"
+   * @example "node:path"
+   */
+  from: ICodegenFile | string;
+  /**
+   * Names of the symbols imported from the source.
+   *
+   * Must be non-empty unless `isNamespaceImport` is true.
+   * All imported names, regardless of whether they are used as types or values.
+   *
+   * @example ["User", "UserDTO"]
+   */
+  names?: ReadonlyArray<string>;
+  /**
+   * If this import is a namespace import (e.g. `import * as ns from "..."`),
+   * this should be the namespace alias. Set to `true` if no alias is needed.
+   *
+   * @example "utils"
+   * @example true
+   */
+  namespaceImport?: boolean | string;
+  /**
+   * Whether the default import is type-only.
+   *
+   * @example true
+   */
+  typeDefaultImport?: boolean;
+  /**
+   * Subset of `names` that are imported using the `type` modifier.
+   * These symbols will be emitted as type-only imports in TypeScript.
+   *
+   * @example ["UserDTO"]
+   */
+  typeNames?: ReadonlyArray<string>;
+  /**
+   * Whether the namespace import is type-only.
+   *
+   * @example true
+   */
+  typeNamespaceImport?: boolean;
+}
+
+declare class CodegenFile implements ICodegenFile {
+    path: string;
+    meta: ICodegenFile['meta'];
+    private cache;
+    private state;
+    constructor(path: string, meta?: ICodegenFile['meta']);
+    addExport(exp: ICodegenImport): void;
+    addImport(imp: ICodegenImport): void;
+    private addImportExport;
+    addSymbol(symbol: ICodegenSymbol): void;
+    get exports(): ReadonlyArray<ICodegenImport>;
+    getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+    hasContent(): boolean;
+    hasSymbol(name: string): boolean;
+    get imports(): ReadonlyArray<ICodegenImport>;
+    private mergeImportExportValues;
+    static pathToFilePath(source: string): string;
+    relativePathFromFile(file: Pick<ICodegenFile, 'path'>): string;
+    relativePathToFile(file: Pick<ICodegenFile, 'path'>): string;
+    get symbols(): ReadonlyArray<ICodegenSymbol>;
+}
+
+/**
+ * Represents a code generation project consisting of multiple codegen files.
+ * Manages imports, symbols, and output generation across the project.
+ */
+interface ICodegenProject {
+  /**
+   * Adds an export declaration to a specific file, creating the file if it doesn't exist.
+   *
+   * @param fileOrPath - File instance or file path where to add the export.
+   * @param imp - The export declaration to add.
+   * @example
+   * project.addExportToFile("models/user.ts", { from: "lib", names: ["User"] });
+   */
+  addExportToFile(fileOrPath: ICodegenFile | string, imp: ICodegenImport): void;
+  /**
+   * Adds an import declaration to a specific file, creating the file if it doesn't exist.
+   *
+   * @param fileOrPath - File instance or file path where to add the import.
+   * @param imp - The import declaration to add.
+   * @example
+   * project.addImportToFile("models/user.ts", { from: "lib", names: ["User"] });
+   */
+  addImportToFile(fileOrPath: ICodegenFile | string, imp: ICodegenImport): void;
+  /**
+   * Adds a symbol to a specific file, creating the file if it doesn't exist.
+   *
+   * @param fileOrPath - File instance or file path where to add the symbol.
+   * @param symbol - The symbol to add.
+   * @example
+   * project.addSymbolToFile("models/user.ts", { name: "User", value: tsNode });
+   */
+  addSymbolToFile(
+    fileOrPath: ICodegenFile | string,
+    symbol: ICodegenSymbol,
+  ): void;
+  /**
+   * Creates a new codegen file with optional metadata and adds it to the project.
+   *
+   * If a file with the same path already exists, it is returned instead.
+   *
+   * @param path - The logical output path for the file (e.g. "models/user.ts").
+   * @param meta - Optional renderer and metadata to attach to the file (e.g. { isInternal: true }).
+   * @returns The newly created file instance.
+   * @example
+   * const file = project.createFile("models/user.ts", { isInternal: true });
+   */
+  createFile(
+    path: string,
+    meta?: ICodegenFile['meta'] & { renderer?: ICodegenRenderer },
+  ): ICodegenFile;
+  /**
+   * Ensures a codegen file exists and returns it.
+   *
+   * If a file does not exist yet, it is created with minimal information.
+   * Later, it is expected `createFile()` will be called which will fill in
+   * the missing information such as optional metadata.
+   *
+   * @param fileOrPath - The logical output path for the file or the file itself.
+   * @returns The file instance.
+   * @example
+   * const file = project.ensureFile("models/user.ts");
+   */
+  ensureFile(fileOrPath: ICodegenFile | string): ICodegenFile;
+  /**
+   * Returns all files in the project in insertion order.
+   *
+   * @example
+   * project.files.forEach(file => console.log(file.path));
+   */
+  readonly files: ReadonlyArray<ICodegenFile>;
+  /**
+   * Returns all symbols declared or imported across all files.
+   *
+   * @returns Flattened list of all codegen symbols.
+   * @example
+   * project.getAllSymbols().filter(s => s.name === "User");
+   */
+  getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+  /**
+   * Retrieves a file by its logical output path.
+   *
+   * @param path - The file path to find.
+   * @returns The file if found, or undefined otherwise.
+   * @example
+   * const file = project.getFileByPath("models/user.ts");
+   */
+  getFileByPath(path: string): ICodegenFile | undefined;
+  /**
+   * Produces output representations for all files in the project.
+   *
+   * @param meta Arbitrary metadata.
+   * @returns Array of outputs ready for writing or further processing.
+   * @example
+   * project.render().forEach(output => writeFile(output));
+   */
+  render(meta?: ICodegenMeta): ReadonlyArray<ICodegenOutput>;
+}
+
+declare class CodegenProject implements ICodegenProject {
+    private filesMap;
+    private filesOrder;
+    private renderers;
+    addExportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void;
+    addImportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void;
+    addSymbolToFile(fileOrPath: CodegenFile | string, symbol: ICodegenSymbol): void;
+    createFile(path: string, meta?: Omit<CodegenFile['meta'], 'renderer'> & {
+        /**
+         * Renderer to use to render this file.
+         */
+        renderer?: ICodegenRenderer;
+    }): CodegenFile;
+    ensureFile(fileOrPath: CodegenFile | string): CodegenFile;
+    private ensureRenderer;
+    get files(): ReadonlyArray<CodegenFile>;
+    getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+    getFileByPath(path: string): CodegenFile | undefined;
+    render(meta?: ICodegenMeta): ReadonlyArray<ICodegenOutput>;
+}
+
+export { CodegenFile, CodegenProject, type ICodegenFile, type ICodegenImport, type ICodegenMeta, type ICodegenOutput, type ICodegenProject, type ICodegenRenderer, type ICodegenSymbol };

package/dist/index.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Arbitrary metadata passed to render functions.
+ *
+ * Implementors should extend this interface for their own needs.
+ */
+interface ICodegenMeta {
+  [key: string]: unknown;
+}
+
+interface ICodegenOutput {
+  /**
+   * The main content of the file to output.
+   *
+   * A raw string representing source code.
+   *
+   * @example "function foo(): void {\n  // implementation\n}\n"
+   */
+  content: string;
+  /**
+   * Optional metadata or hints for the emitter, such as formatting options,
+   * source maps, or language-specific flags.
+   *
+   * @example { format: "prettier", sourceMap: true }
+   */
+  meta: Record<string, unknown>;
+  /**
+   * Logical output path (used for writing the file).
+   *
+   * @example "models/user.ts"
+   */
+  path: string;
+}
+
+interface ICodegenRenderer {
+  /**
+   * Optional: hook for renderer-level setup logic (e.g., formatting, config)
+   */
+  configure?(options: Record<string, unknown>): void;
+  /**
+   * Unique identifier for this renderer.
+   *
+   * @example "typescript"
+   */
+  id: string;
+  /**
+   * Returns printable data.
+   *
+   * @param file The file to render.
+   * @param meta Arbitrary metadata.
+   * @returns Output for file emit step
+   */
+  render(file: CodegenFile, meta?: ICodegenMeta): ICodegenOutput;
+}
+
+interface ICodegenSymbol {
+  /**
+   * Optional description or doc comment.
+   *
+   * @example "Represents a user in the system"
+   */
+  description?: string;
+  /**
+   * Optional kind of symbol (e.g. "class", "function", "type", etc.).
+   *
+   * @example "class"
+   */
+  kind?: string;
+  /**
+   * Unique identifier for the symbol within its file.
+   *
+   * @example "UserModel"
+   */
+  name: string;
+  /**
+   * Internal representation of the symbol (e.g. AST node, IR object, raw
+   * code). Used to generate output.
+   */
+  value?: unknown;
+}
+
+interface ICodegenFile {
+  /**
+   * Adds an export to this file.
+   *
+   * This is also known as a re-export.
+   *
+   * @param exp The export to add
+   */
+  addExport(exp: ICodegenImport): void;
+  /**
+   * Adds an import to this file.
+   *
+   * @param imp The import to add
+   */
+  addImport(imp: ICodegenImport): void;
+  /**
+   * Adds a symbol defined by this file.
+   *
+   * @param symbol The symbol to add
+   */
+  addSymbol(symbol: ICodegenSymbol): void;
+  /**
+   * Symbols exported from other files.
+   **/
+  exports: ReadonlyArray<ICodegenImport>;
+  /**
+   * Returns all symbols used in this file (declared + imported).
+   *
+   * @returns List of all symbols used in this file
+   */
+  getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+  /**
+   * Checks if this file contains any content.
+   *
+   * This is used to determine whether we want to process the file further.
+   * By default, we consider only symbols and exports as content.
+   *
+   * @returns True if the file contains content
+   */
+  hasContent(): boolean;
+  /**
+   * Checks if this file defines a symbol with the given name.
+   *
+   * @param name Symbol name to check
+   * @returns True if the symbol is defined by this file
+   */
+  hasSymbol(name: string): boolean;
+  /**
+   * Symbols imported from other files.
+   **/
+  imports: ReadonlyArray<ICodegenImport>;
+  /**
+   * Optional metadata about the file.
+   **/
+  meta: {
+    /**
+     * Optional file extension.
+     *
+     * @example ".ts"
+     */
+    extension?: '.ts' | (string & {});
+    /**
+     * Optional logical module or package name.
+     *
+     * @example "models.user"
+     */
+    moduleName?: string;
+    /**
+     * Optional path transformer.
+     *
+     * @param path Original file path passed to the constructor.
+     */
+    path?: ((path: string) => string) | string;
+    /**
+     * Renderer ID.
+     *
+     * @example "typescript"
+     */
+    renderer?: ICodegenRenderer['id'];
+  };
+  /**
+   * Logical output path (used for writing the file).
+   *
+   * @example "models/user.ts"
+   */
+  path: string;
+  /**
+   * Returns a relative path to this file from another file.
+   *
+   * @param file The file from which we want the relative path to this file.
+   * @example "./this-file.ts"
+   */
+  relativePathFromFile(file: Pick<ICodegenFile, 'path'>): string;
+  /**
+   * Returns a relative path to file from this file.
+   *
+   * @param file The file to which we want the relative path.
+   * @example "./another-file.ts"
+   */
+  relativePathToFile(file: Pick<ICodegenFile, 'path'>): string;
+  /**
+   * Top-level symbols declared in this file.
+   **/
+  symbols: ReadonlyArray<ICodegenSymbol>;
+}
+
+interface ICodegenImport {
+  /**
+   * Optional aliasing map for imported symbols.
+   *
+   * Keys must be a subset of `names`, values are aliases.
+   *
+   * @example { User: "ImportedUser" }
+   */
+  aliases?: Record<string, string>;
+  /**
+   * Name of the default import, if any.
+   *
+   * @example "React"
+   */
+  defaultImport?: string;
+  /**
+   * Source file or external module from which symbols are imported.
+   *
+   * For internal files, this should be a ICodegenFile instance to enable
+   * dynamic path computation. For external or system modules, use a string.
+   *
+   * @example "./models/user"
+   * @example "node:path"
+   */
+  from: ICodegenFile | string;
+  /**
+   * Names of the symbols imported from the source.
+   *
+   * Must be non-empty unless `isNamespaceImport` is true.
+   * All imported names, regardless of whether they are used as types or values.
+   *
+   * @example ["User", "UserDTO"]
+   */
+  names?: ReadonlyArray<string>;
+  /**
+   * If this import is a namespace import (e.g. `import * as ns from "..."`),
+   * this should be the namespace alias. Set to `true` if no alias is needed.
+   *
+   * @example "utils"
+   * @example true
+   */
+  namespaceImport?: boolean | string;
+  /**
+   * Whether the default import is type-only.
+   *
+   * @example true
+   */
+  typeDefaultImport?: boolean;
+  /**
+   * Subset of `names` that are imported using the `type` modifier.
+   * These symbols will be emitted as type-only imports in TypeScript.
+   *
+   * @example ["UserDTO"]
+   */
+  typeNames?: ReadonlyArray<string>;
+  /**
+   * Whether the namespace import is type-only.
+   *
+   * @example true
+   */
+  typeNamespaceImport?: boolean;
+}
+
+declare class CodegenFile implements ICodegenFile {
+    path: string;
+    meta: ICodegenFile['meta'];
+    private cache;
+    private state;
+    constructor(path: string, meta?: ICodegenFile['meta']);
+    addExport(exp: ICodegenImport): void;
+    addImport(imp: ICodegenImport): void;
+    private addImportExport;
+    addSymbol(symbol: ICodegenSymbol): void;
+    get exports(): ReadonlyArray<ICodegenImport>;
+    getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+    hasContent(): boolean;
+    hasSymbol(name: string): boolean;
+    get imports(): ReadonlyArray<ICodegenImport>;
+    private mergeImportExportValues;
+    static pathToFilePath(source: string): string;
+    relativePathFromFile(file: Pick<ICodegenFile, 'path'>): string;
+    relativePathToFile(file: Pick<ICodegenFile, 'path'>): string;
+    get symbols(): ReadonlyArray<ICodegenSymbol>;
+}
+
+/**
+ * Represents a code generation project consisting of multiple codegen files.
+ * Manages imports, symbols, and output generation across the project.
+ */
+interface ICodegenProject {
+  /**
+   * Adds an export declaration to a specific file, creating the file if it doesn't exist.
+   *
+   * @param fileOrPath - File instance or file path where to add the export.
+   * @param imp - The export declaration to add.
+   * @example
+   * project.addExportToFile("models/user.ts", { from: "lib", names: ["User"] });
+   */
+  addExportToFile(fileOrPath: ICodegenFile | string, imp: ICodegenImport): void;
+  /**
+   * Adds an import declaration to a specific file, creating the file if it doesn't exist.
+   *
+   * @param fileOrPath - File instance or file path where to add the import.
+   * @param imp - The import declaration to add.
+   * @example
+   * project.addImportToFile("models/user.ts", { from: "lib", names: ["User"] });
+   */
+  addImportToFile(fileOrPath: ICodegenFile | string, imp: ICodegenImport): void;
+  /**
+   * Adds a symbol to a specific file, creating the file if it doesn't exist.
+   *
+   * @param fileOrPath - File instance or file path where to add the symbol.
+   * @param symbol - The symbol to add.
+   * @example
+   * project.addSymbolToFile("models/user.ts", { name: "User", value: tsNode });
+   */
+  addSymbolToFile(
+    fileOrPath: ICodegenFile | string,
+    symbol: ICodegenSymbol,
+  ): void;
+  /**
+   * Creates a new codegen file with optional metadata and adds it to the project.
+   *
+   * If a file with the same path already exists, it is returned instead.
+   *
+   * @param path - The logical output path for the file (e.g. "models/user.ts").
+   * @param meta - Optional renderer and metadata to attach to the file (e.g. { isInternal: true }).
+   * @returns The newly created file instance.
+   * @example
+   * const file = project.createFile("models/user.ts", { isInternal: true });
+   */
+  createFile(
+    path: string,
+    meta?: ICodegenFile['meta'] & { renderer?: ICodegenRenderer },
+  ): ICodegenFile;
+  /**
+   * Ensures a codegen file exists and returns it.
+   *
+   * If a file does not exist yet, it is created with minimal information.
+   * Later, it is expected `createFile()` will be called which will fill in
+   * the missing information such as optional metadata.
+   *
+   * @param fileOrPath - The logical output path for the file or the file itself.
+   * @returns The file instance.
+   * @example
+   * const file = project.ensureFile("models/user.ts");
+   */
+  ensureFile(fileOrPath: ICodegenFile | string): ICodegenFile;
+  /**
+   * Returns all files in the project in insertion order.
+   *
+   * @example
+   * project.files.forEach(file => console.log(file.path));
+   */
+  readonly files: ReadonlyArray<ICodegenFile>;
+  /**
+   * Returns all symbols declared or imported across all files.
+   *
+   * @returns Flattened list of all codegen symbols.
+   * @example
+   * project.getAllSymbols().filter(s => s.name === "User");
+   */
+  getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+  /**
+   * Retrieves a file by its logical output path.
+   *
+   * @param path - The file path to find.
+   * @returns The file if found, or undefined otherwise.
+   * @example
+   * const file = project.getFileByPath("models/user.ts");
+   */
+  getFileByPath(path: string): ICodegenFile | undefined;
+  /**
+   * Produces output representations for all files in the project.
+   *
+   * @param meta Arbitrary metadata.
+   * @returns Array of outputs ready for writing or further processing.
+   * @example
+   * project.render().forEach(output => writeFile(output));
+   */
+  render(meta?: ICodegenMeta): ReadonlyArray<ICodegenOutput>;
+}
+
+declare class CodegenProject implements ICodegenProject {
+    private filesMap;
+    private filesOrder;
+    private renderers;
+    addExportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void;
+    addImportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void;
+    addSymbolToFile(fileOrPath: CodegenFile | string, symbol: ICodegenSymbol): void;
+    createFile(path: string, meta?: Omit<CodegenFile['meta'], 'renderer'> & {
+        /**
+         * Renderer to use to render this file.
+         */
+        renderer?: ICodegenRenderer;
+    }): CodegenFile;
+    ensureFile(fileOrPath: CodegenFile | string): CodegenFile;
+    private ensureRenderer;
+    get files(): ReadonlyArray<CodegenFile>;
+    getAllSymbols(): ReadonlyArray<ICodegenSymbol>;
+    getFileByPath(path: string): CodegenFile | undefined;
+    render(meta?: ICodegenMeta): ReadonlyArray<ICodegenOutput>;
+}
+
+export { CodegenFile, CodegenProject, type ICodegenFile, type ICodegenImport, type ICodegenMeta, type ICodegenOutput, type ICodegenProject, type ICodegenRenderer, type ICodegenSymbol };

package/dist/index.js

@@ -0,0 +1,3 @@
+import {createRequire}from'module';import s from'node:path';createRequire(import.meta.url);
+var i=class d{constructor(e,t={}){this.path=e;this.meta=t;let r=d.pathToFilePath(e);t.path&&(typeof t.path=="function"?r=t.path(r):r=t.path.replace("{{path}}",r)),this.path=r;}cache={};state={exports:new Map,imports:new Map,symbols:new Map};addExport(e){return this.addImportExport(e,"exports")}addImport(e){return this.addImportExport(e,"imports")}addImportExport(e,t){let r=typeof e.from=="string"?e.from:e.from.path,o=this.state[t].get(r);o?(this.mergeImportExportValues(o,e),this.state[t].set(r,o)):this.state[t].set(r,{...e}),this.cache[t]=void 0;}addSymbol(e){let t=e.name,r=this.state.symbols.get(t);r?(r.value=e.value,this.state.symbols.set(t,r)):this.state.symbols.set(t,{...e}),this.cache.symbols=void 0;}get exports(){return this.cache.exports||(this.cache.exports=Array.from(this.state.exports.values())),this.cache.exports}getAllSymbols(){return [...this.symbols,...this.imports.flatMap(e=>(e.names??[]).map(t=>({name:e.aliases?.[t]??t}))),...this.exports.flatMap(e=>(e.names??[]).map(t=>({name:e.aliases?.[t]??t})))]}hasContent(){return this.state.symbols.size>0||this.state.exports.size>0}hasSymbol(e){return this.state.symbols.has(e)}get imports(){return this.cache.imports||(this.cache.imports=Array.from(this.state.imports.values())),this.cache.imports}mergeImportExportValues(e,t){e.aliases={...e.aliases,...t.aliases},t.defaultImport!==void 0&&(e.defaultImport=t.defaultImport),e.names=[...new Set([...e.names??[],...t.names??[]])],t.namespaceImport!==void 0&&(e.namespaceImport=t.namespaceImport),t.typeDefaultImport!==void 0&&(e.typeDefaultImport=t.typeDefaultImport),e.typeNames=[...new Set([...e.typeNames??[],...t.typeNames??[]])],t.typeNamespaceImport!==void 0&&(e.typeNamespaceImport=t.typeNamespaceImport);}static pathToFilePath(e){return e.includes("/")?e.split("/").filter(Boolean).join(s.sep):e.includes("\\")?e.split("\\").filter(Boolean).join(s.sep):e.split(s.sep).filter(Boolean).join(s.sep)}relativePathFromFile(e){let t=s.posix.relative(s.posix.dirname(e.path),this.path);return t.startsWith(".")||(t=`./${t}`),t}relativePathToFile(e){let t=s.posix.relative(s.posix.dirname(this.path),e.path);return t.startsWith(".")||(t=`./${t}`),t}get symbols(){return this.cache.symbols||(this.cache.symbols=Array.from(this.state.symbols.values())),this.cache.symbols}};var a=class{filesMap=new Map;filesOrder=[];renderers=new Map;addExportToFile(e,t){this.ensureFile(e).addExport(t);}addImportToFile(e,t){this.ensureFile(e).addImport(t);}addSymbolToFile(e,t){this.ensureFile(e).addSymbol(t);}createFile(e,t={}){let{renderer:r,...o}=t;r&&this.ensureRenderer(r);let n=this.getFileByPath(e);if(n)return r?.id&&r.id!==n.meta.renderer&&(n.meta.renderer=r.id),n;let p=new i(e,{...o,renderer:r?.id});return this.filesOrder.push(p),this.filesMap.set(e,p),p}ensureFile(e){if(typeof e!="string")return e;let t=this.getFileByPath(e);return t||this.createFile(e)}ensureRenderer(e){return this.renderers.has(e.id)||this.renderers.set(e.id,e),this.renderers.get(e.id)}get files(){return [...this.filesOrder]}getAllSymbols(){return this.filesOrder.flatMap(e=>e.getAllSymbols())}getFileByPath(e){return this.filesMap.get(e)}render(e){let t=[];for(let r of this.filesOrder){if(!r.meta.renderer)continue;let o=this.renderers.get(r.meta.renderer);o&&t.push(o.render(r,e));}return t}};export{i as CodegenFile,a as CodegenProject};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/files/file.ts","../src/project/project.ts"],"names":["CodegenFile","_CodegenFile","path","meta","filePath","exp","imp","value","field","key","existing","symbol","name","target","source","file","relativePath","CodegenProject","fileOrPath","renderer","metadata","existingFile","results"],"mappings":";AAMO,IAAMA,EAAN,MAAMC,CAAoC,CAiB/C,WAAA,CACSC,CAAAA,CACAC,EAA6B,EAAC,CACrC,CAFO,IAAA,CAAA,IAAA,CAAAD,CAAAA,CACA,UAAAC,CAAAA,CAEP,IAAIC,EAAWH,CAAAA,CAAY,cAAA,CAAeC,CAAI,CAAA,CAC1CC,EAAK,IAAA,GACH,OAAOA,EAAK,IAAA,EAAS,UAAA,CACvBC,EAAWD,CAAAA,CAAK,IAAA,CAAKC,CAAQ,CAAA,CAE7BA,CAAAA,CAAWD,EAAK,IAAA,CAAK,OAAA,CAAQ,WAAYC,CAAQ,CAAA,CAAA,CAGrD,KAAK,IAAA,CAAOA,EACd,CA7BQ,KAAA,CAIJ,EAAC,CAEG,KAAA,CAIJ,CACF,OAAA,CAAS,IAAI,IACb,OAAA,CAAS,IAAI,IACb,OAAA,CAAS,IAAI,GACf,CAAA,CAiBA,SAAA,CAAUC,EAA2B,CACnC,OAAO,KAAK,eAAA,CAAgBA,CAAAA,CAAK,SAAS,CAC5C,CAEA,SAAA,CAAUC,CAAAA,CAA2B,CACnC,OAAO,IAAA,CAAK,gBAAgBA,CAAAA,CAAK,SAAS,CAC5C,CAEQ,eAAA,CACNC,EACAC,CAAAA,CACM,CACN,IAAMC,CAAAA,CAAM,OAAOF,EAAM,IAAA,EAAS,QAAA,CAAWA,CAAAA,CAAM,IAAA,CAAOA,EAAM,IAAA,CAAK,IAAA,CAC/DG,EAAW,IAAA,CAAK,KAAA,CAAMF,CAAK,CAAA,CAAE,GAAA,CAAIC,CAAG,CAAA,CACtCC,CAAAA,EACF,KAAK,uBAAA,CAAwBA,CAAAA,CAAUH,CAAK,CAAA,CAC5C,IAAA,CAAK,MAAMC,CAAK,CAAA,CAAE,GAAA,CAAIC,CAAAA,CAAKC,CAAQ,CAAA,EAEnC,IAAA,CAAK,MAAMF,CAAK,CAAA,CAAE,IAAIC,CAAAA,CAAK,CAAE,GAAGF,CAAM,CAAC,EAEzC,IAAA,CAAK,KAAA,CAAMC,CAAK,CAAA,CAAI,OACtB,CAEA,SAAA,CAAUG,CAAAA,CAA8B,CACtC,IAAMF,EAAME,CAAAA,CAAO,IAAA,CACbD,EAAW,IAAA,CAAK,KAAA,CAAM,QAAQ,GAAA,CAAID,CAAG,EACvCC,CAAAA,EACFA,CAAAA,CAAS,MAAQC,CAAAA,CAAO,KAAA,CACxB,KAAK,KAAA,CAAM,OAAA,CAAQ,IAAIF,CAAAA,CAAKC,CAAQ,GAEpC,IAAA,CAAK,KAAA,CAAM,QAAQ,GAAA,CAAID,CAAAA,CAAK,CAAE,GAAGE,CAAO,CAAC,CAAA,CAE3C,IAAA,CAAK,MAAM,OAAA,CAAU,OACvB,CAEA,IAAI,OAAA,EAAyC,CAC3C,OAAK,IAAA,CAAK,MAAM,OAAA,GACd,IAAA,CAAK,KAAA,CAAM,OAAA,CAAU,MAAM,IAAA,CAAK,IAAA,CAAK,MAAM,OAAA,CAAQ,MAAA,EAAQ,CAAA,CAAA,CAEtD,IAAA,CAAK,MAAM,OACpB,CAEA,eAA+C,CAC7C,OAAO,CACL,GAAG,IAAA,CAAK,QACR,GAAG,IAAA,CAAK,OAAA,CAAQ,OAAA,CAASL,IACtBA,CAAAA,CAAI,KAAA,EAAS,EAAC,EAAG,GAAA,CAAKM,IAAU,CAC/B,IAAA,CAAMN,EAAI,OAAA,GAAUM,CAAI,GAAKA,CAC/B,CAAA,CAAE,CACJ,CAAA,CACA,GAAG,KAAK,OAAA,CAAQ,OAAA,CAASN,CAAAA,EAAAA,CACtBA,CAAAA,CAAI,OAAS,EAAC,EAAG,IAAKM,CAAAA,GAAU,CAC/B,KAAMN,CAAAA,CAAI,OAAA,GAAUM,CAAI,CAAA,EAAKA,CAC/B,EAAE,CACJ,CACF,CACF,CAEA,UAAA,EAAsB,CACpB,OAAO,IAAA,CAAK,MAAM,OAAA,CAAQ,IAAA,CAAO,GAAK,IAAA,CAAK,KAAA,CAAM,QAAQ,IAAA,CAAO,CAClE,CAEA,SAAA,CAAUA,CAAAA,CAAuB,CAC/B,OAAO,IAAA,CAAK,MAAM,OAAA,CAAQ,GAAA,CAAIA,CAAI,CACpC,CAEA,IAAI,OAAA,EAAyC,CAC3C,OAAK,IAAA,CAAK,MAAM,OAAA,GACd,IAAA,CAAK,MAAM,OAAA,CAAU,KAAA,CAAM,KAAK,IAAA,CAAK,KAAA,CAAM,QAAQ,MAAA,EAAQ,GAEtD,IAAA,CAAK,KAAA,CAAM,OACpB,CAEQ,uBAAA,CACNC,EACAC,CAAAA,CACM,CACND,CAAAA,CAAO,OAAA,CAAU,CAAE,GAAGA,CAAAA,CAAO,QAAS,GAAGC,CAAAA,CAAO,OAAQ,CAAA,CACpDA,CAAAA,CAAO,gBAAkB,MAAA,GAC3BD,CAAAA,CAAO,cAAgBC,CAAAA,CAAO,aAAA,CAAA,CAEhCD,EAAO,KAAA,CAAQ,CACb,GAAG,IAAI,GAAA,CAAI,CAAC,GAAIA,EAAO,KAAA,EAAS,GAAK,GAAIC,CAAAA,CAAO,OAAS,EAAG,CAAC,CAC/D,CAAA,CACIA,EAAO,eAAA,GAAoB,MAAA,GAC7BD,EAAO,eAAA,CAAkBC,CAAAA,CAAO,iBAE9BA,CAAAA,CAAO,iBAAA,GAAsB,SAC/BD,CAAAA,CAAO,iBAAA,CAAoBC,EAAO,iBAAA,CAAA,CAEpCD,CAAAA,CAAO,UAAY,CACjB,GAAG,IAAI,GAAA,CAAI,CAAC,GAAIA,CAAAA,CAAO,SAAA,EAAa,EAAC,CAAI,GAAIC,EAAO,SAAA,EAAa,EAAG,CAAC,CACvE,CAAA,CACIA,CAAAA,CAAO,sBAAwB,MAAA,GACjCD,CAAAA,CAAO,oBAAsBC,CAAAA,CAAO,mBAAA,EAExC,CAEA,OAAO,cAAA,CAAeA,EAAwB,CAC5C,OAAIA,EAAO,QAAA,CAAS,GAAG,EACdA,CAAAA,CAAO,KAAA,CAAM,GAAG,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,CAAE,KAAKZ,CAAAA,CAAK,GAAG,EAEpDY,CAAAA,CAAO,QAAA,CAAS,IAAI,CAAA,CACfA,CAAAA,CAAO,MAAM,IAAI,CAAA,CAAE,OAAO,OAAO,CAAA,CAAE,KAAKZ,CAAAA,CAAK,GAAG,EAElDY,CAAAA,CAAO,KAAA,CAAMZ,CAAAA,CAAK,GAAG,EAAE,MAAA,CAAO,OAAO,EAAE,IAAA,CAAKA,CAAAA,CAAK,GAAG,CAC7D,CAEA,qBAAqBa,CAAAA,CAA0C,CAC7D,IAAIC,CAAAA,CAAed,CAAAA,CAAK,MAAM,QAAA,CAC5BA,CAAAA,CAAK,MAAM,OAAA,CAAQa,CAAAA,CAAK,IAAI,CAAA,CAC5B,KAAK,IACP,CAAA,CACA,OAAKC,CAAAA,CAAa,UAAA,CAAW,GAAG,CAAA,GAC9BA,CAAAA,CAAe,KAAKA,CAAY,CAAA,CAAA,CAAA,CAE3BA,CACT,CAEA,kBAAA,CAAmBD,EAA0C,CAC3D,IAAIC,EAAed,CAAAA,CAAK,KAAA,CAAM,QAAA,CAC5BA,CAAAA,CAAK,MAAM,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,CAC5Ba,CAAAA,CAAK,IACP,CAAA,CACA,OAAKC,EAAa,UAAA,CAAW,GAAG,IAC9BA,CAAAA,CAAe,CAAA,EAAA,EAAKA,CAAY,CAAA,CAAA,CAAA,CAE3BA,CACT,CAEA,IAAI,OAAA,EAAyC,CAC3C,OAAK,KAAK,KAAA,CAAM,OAAA,GACd,KAAK,KAAA,CAAM,OAAA,CAAU,MAAM,IAAA,CAAK,IAAA,CAAK,MAAM,OAAA,CAAQ,MAAA,EAAQ,CAAA,CAAA,CAEtD,IAAA,CAAK,MAAM,OACpB,CACF,ECtKO,IAAMC,CAAAA,CAAN,KAAgD,CAC7C,SAAqC,IAAI,GAAA,CACzC,WAAiC,EAAC,CAClC,UAA2C,IAAI,GAAA,CAEvD,gBAAgBC,CAAAA,CAAkCZ,CAAAA,CAA2B,CAC9D,IAAA,CAAK,UAAA,CAAWY,CAAU,CAAA,CAClC,SAAA,CAAUZ,CAAG,EACpB,CAEA,gBAAgBY,CAAAA,CAAkCZ,CAAAA,CAA2B,CAC9D,IAAA,CAAK,UAAA,CAAWY,CAAU,CAAA,CAClC,SAAA,CAAUZ,CAAG,EACpB,CAEA,gBACEY,CAAAA,CACAP,CAAAA,CACM,CACO,IAAA,CAAK,UAAA,CAAWO,CAAU,CAAA,CAClC,SAAA,CAAUP,CAAM,EACvB,CAEA,UAAA,CACET,CAAAA,CACAC,EAKI,EAAC,CACQ,CACb,GAAM,CAAE,SAAAgB,CAAAA,CAAU,GAAGC,CAAS,CAAA,CAAIjB,CAAAA,CAC9BgB,GACF,IAAA,CAAK,cAAA,CAAeA,CAAQ,CAAA,CAG9B,IAAMT,EAAW,IAAA,CAAK,aAAA,CAAcR,CAAI,CAAA,CACxC,GAAIQ,CAAAA,CAEF,OAAIS,GAAU,EAAA,EAAMA,CAAAA,CAAS,KAAOT,CAAAA,CAAS,IAAA,CAAK,WAChDA,CAAAA,CAAS,IAAA,CAAK,SAAWS,CAAAA,CAAS,EAAA,CAAA,CAE7BT,EAGT,IAAMK,CAAAA,CAAO,IAAIf,CAAAA,CAAYE,CAAAA,CAAM,CACjC,GAAGkB,EACH,QAAA,CAAUD,CAAAA,EAAU,EACtB,CAAC,CAAA,CACD,YAAK,UAAA,CAAW,IAAA,CAAKJ,CAAI,CAAA,CACzB,IAAA,CAAK,SAAS,GAAA,CAAIb,CAAAA,CAAMa,CAAI,CAAA,CACrBA,CACT,CAEA,UAAA,CAAWG,CAAAA,CAA+C,CACxD,GAAI,OAAOA,GAAe,QAAA,CACxB,OAAOA,EAET,IAAMG,CAAAA,CAAe,KAAK,aAAA,CAAcH,CAAU,EAClD,OAAIG,CAAAA,EAGG,KAAK,UAAA,CAAWH,CAAU,CACnC,CAEQ,cAAA,CAAeC,EAA8C,CACnE,OAAK,IAAA,CAAK,SAAA,CAAU,IAAIA,CAAAA,CAAS,EAAE,GACjC,IAAA,CAAK,SAAA,CAAU,IAAIA,CAAAA,CAAS,EAAA,CAAIA,CAAQ,CAAA,CAEnC,IAAA,CAAK,UAAU,GAAA,CAAIA,CAAAA,CAAS,EAAE,CACvC,CAEA,IAAI,KAAA,EAAoC,CACtC,OAAO,CAAC,GAAG,IAAA,CAAK,UAAU,CAC5B,CAEA,aAAA,EAA+C,CAC7C,OAAO,IAAA,CAAK,WAAW,OAAA,CAASJ,CAAAA,EAASA,EAAK,aAAA,EAAe,CAC/D,CAEA,aAAA,CAAcb,EAAuC,CACnD,OAAO,IAAA,CAAK,QAAA,CAAS,IAAIA,CAAI,CAC/B,CAEA,MAAA,CAAOC,CAAAA,CAAoD,CACzD,IAAMmB,CAAAA,CAAiC,EAAC,CACxC,IAAA,IAAWP,KAAQ,IAAA,CAAK,UAAA,CAAY,CAClC,GAAI,CAACA,EAAK,IAAA,CAAK,QAAA,CAAU,SACzB,IAAMI,CAAAA,CAAW,KAAK,SAAA,CAAU,GAAA,CAAIJ,EAAK,IAAA,CAAK,QAAQ,EACjDI,CAAAA,EACLG,CAAAA,CAAQ,KAAKH,CAAAA,CAAS,MAAA,CAAOJ,EAAMZ,CAAI,CAAC,EAC1C,CACA,OAAOmB,CACT,CACF","file":"index.js","sourcesContent":["import path from 'node:path';\n\nimport type { ICodegenImport } from '../imports/types';\nimport type { ICodegenSymbol } from '../symbols/types';\nimport type { ICodegenFile } from './types';\n\nexport class CodegenFile implements ICodegenFile {\n  private cache: {\n    exports?: ReadonlyArray<ICodegenImport>;\n    imports?: ReadonlyArray<ICodegenImport>;\n    symbols?: ReadonlyArray<ICodegenSymbol>;\n  } = {};\n\n  private state: {\n    exports: Map<string, ICodegenImport>;\n    imports: Map<string, ICodegenImport>;\n    symbols: Map<string, ICodegenSymbol>;\n  } = {\n    exports: new Map(),\n    imports: new Map(),\n    symbols: new Map(),\n  };\n\n  constructor(\n    public path: string,\n    public meta: ICodegenFile['meta'] = {},\n  ) {\n    let filePath = CodegenFile.pathToFilePath(path);\n    if (meta.path) {\n      if (typeof meta.path === 'function') {\n        filePath = meta.path(filePath);\n      } else {\n        filePath = meta.path.replace('{{path}}', filePath);\n      }\n    }\n    this.path = filePath;\n  }\n\n  addExport(exp: ICodegenImport): void {\n    return this.addImportExport(exp, 'exports');\n  }\n\n  addImport(imp: ICodegenImport): void {\n    return this.addImportExport(imp, 'imports');\n  }\n\n  private addImportExport(\n    value: ICodegenImport,\n    field: 'exports' | 'imports',\n  ): void {\n    const key = typeof value.from === 'string' ? value.from : value.from.path;\n    const existing = this.state[field].get(key);\n    if (existing) {\n      this.mergeImportExportValues(existing, value);\n      this.state[field].set(key, existing);\n    } else {\n      this.state[field].set(key, { ...value }); // clone to avoid mutation\n    }\n    this.cache[field] = undefined;\n  }\n\n  addSymbol(symbol: ICodegenSymbol): void {\n    const key = symbol.name;\n    const existing = this.state.symbols.get(key);\n    if (existing) {\n      existing.value = symbol.value;\n      this.state.symbols.set(key, existing);\n    } else {\n      this.state.symbols.set(key, { ...symbol }); // clone to avoid mutation\n    }\n    this.cache.symbols = undefined;\n  }\n\n  get exports(): ReadonlyArray<ICodegenImport> {\n    if (!this.cache.exports) {\n      this.cache.exports = Array.from(this.state.exports.values());\n    }\n    return this.cache.exports;\n  }\n\n  getAllSymbols(): ReadonlyArray<ICodegenSymbol> {\n    return [\n      ...this.symbols,\n      ...this.imports.flatMap((imp) =>\n        (imp.names ?? []).map((name) => ({\n          name: imp.aliases?.[name] ?? name,\n        })),\n      ),\n      ...this.exports.flatMap((imp) =>\n        (imp.names ?? []).map((name) => ({\n          name: imp.aliases?.[name] ?? name,\n        })),\n      ),\n    ];\n  }\n\n  hasContent(): boolean {\n    return this.state.symbols.size > 0 || this.state.exports.size > 0;\n  }\n\n  hasSymbol(name: string): boolean {\n    return this.state.symbols.has(name);\n  }\n\n  get imports(): ReadonlyArray<ICodegenImport> {\n    if (!this.cache.imports) {\n      this.cache.imports = Array.from(this.state.imports.values());\n    }\n    return this.cache.imports;\n  }\n\n  private mergeImportExportValues(\n    target: ICodegenImport,\n    source: ICodegenImport,\n  ): void {\n    target.aliases = { ...target.aliases, ...source.aliases };\n    if (source.defaultImport !== undefined) {\n      target.defaultImport = source.defaultImport;\n    }\n    target.names = [\n      ...new Set([...(target.names ?? []), ...(source.names ?? [])]),\n    ];\n    if (source.namespaceImport !== undefined) {\n      target.namespaceImport = source.namespaceImport;\n    }\n    if (source.typeDefaultImport !== undefined) {\n      target.typeDefaultImport = source.typeDefaultImport;\n    }\n    target.typeNames = [\n      ...new Set([...(target.typeNames ?? []), ...(source.typeNames ?? [])]),\n    ];\n    if (source.typeNamespaceImport !== undefined) {\n      target.typeNamespaceImport = source.typeNamespaceImport;\n    }\n  }\n\n  static pathToFilePath(source: string): string {\n    if (source.includes('/')) {\n      return source.split('/').filter(Boolean).join(path.sep);\n    }\n    if (source.includes('\\\\')) {\n      return source.split('\\\\').filter(Boolean).join(path.sep);\n    }\n    return source.split(path.sep).filter(Boolean).join(path.sep);\n  }\n\n  relativePathFromFile(file: Pick<ICodegenFile, 'path'>): string {\n    let relativePath = path.posix.relative(\n      path.posix.dirname(file.path),\n      this.path,\n    );\n    if (!relativePath.startsWith('.')) {\n      relativePath = `./${relativePath}`;\n    }\n    return relativePath;\n  }\n\n  relativePathToFile(file: Pick<ICodegenFile, 'path'>): string {\n    let relativePath = path.posix.relative(\n      path.posix.dirname(this.path),\n      file.path,\n    );\n    if (!relativePath.startsWith('.')) {\n      relativePath = `./${relativePath}`;\n    }\n    return relativePath;\n  }\n\n  get symbols(): ReadonlyArray<ICodegenSymbol> {\n    if (!this.cache.symbols) {\n      this.cache.symbols = Array.from(this.state.symbols.values());\n    }\n    return this.cache.symbols;\n  }\n}\n","import { CodegenFile } from '../files/file';\nimport type { ICodegenImport } from '../imports/types';\nimport type { ICodegenMeta } from '../meta/types';\nimport type { ICodegenOutput } from '../output/types';\nimport type { ICodegenRenderer } from '../renderers/types';\nimport type { ICodegenSymbol } from '../symbols/types';\nimport type { ICodegenProject } from './types';\n\nexport class CodegenProject implements ICodegenProject {\n  private filesMap: Map<string, CodegenFile> = new Map();\n  private filesOrder: Array<CodegenFile> = [];\n  private renderers: Map<string, ICodegenRenderer> = new Map();\n\n  addExportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void {\n    const file = this.ensureFile(fileOrPath);\n    file.addExport(imp);\n  }\n\n  addImportToFile(fileOrPath: CodegenFile | string, imp: ICodegenImport): void {\n    const file = this.ensureFile(fileOrPath);\n    file.addImport(imp);\n  }\n\n  addSymbolToFile(\n    fileOrPath: CodegenFile | string,\n    symbol: ICodegenSymbol,\n  ): void {\n    const file = this.ensureFile(fileOrPath);\n    file.addSymbol(symbol);\n  }\n\n  createFile(\n    path: string,\n    meta: Omit<CodegenFile['meta'], 'renderer'> & {\n      /**\n       * Renderer to use to render this file.\n       */\n      renderer?: ICodegenRenderer;\n    } = {},\n  ): CodegenFile {\n    const { renderer, ...metadata } = meta;\n    if (renderer) {\n      this.ensureRenderer(renderer);\n    }\n\n    const existing = this.getFileByPath(path);\n    if (existing) {\n      // Whoever is creating the file will override the renderer\n      if (renderer?.id && renderer.id !== existing.meta.renderer) {\n        existing.meta.renderer = renderer.id;\n      }\n      return existing;\n    }\n\n    const file = new CodegenFile(path, {\n      ...metadata,\n      renderer: renderer?.id,\n    });\n    this.filesOrder.push(file);\n    this.filesMap.set(path, file);\n    return file;\n  }\n\n  ensureFile(fileOrPath: CodegenFile | string): CodegenFile {\n    if (typeof fileOrPath !== 'string') {\n      return fileOrPath;\n    }\n    const existingFile = this.getFileByPath(fileOrPath);\n    if (existingFile) {\n      return existingFile;\n    }\n    return this.createFile(fileOrPath);\n  }\n\n  private ensureRenderer(renderer: ICodegenRenderer): ICodegenRenderer {\n    if (!this.renderers.has(renderer.id)) {\n      this.renderers.set(renderer.id, renderer);\n    }\n    return this.renderers.get(renderer.id)!;\n  }\n\n  get files(): ReadonlyArray<CodegenFile> {\n    return [...this.filesOrder];\n  }\n\n  getAllSymbols(): ReadonlyArray<ICodegenSymbol> {\n    return this.filesOrder.flatMap((file) => file.getAllSymbols());\n  }\n\n  getFileByPath(path: string): CodegenFile | undefined {\n    return this.filesMap.get(path);\n  }\n\n  render(meta?: ICodegenMeta): ReadonlyArray<ICodegenOutput> {\n    const results: Array<ICodegenOutput> = [];\n    for (const file of this.filesOrder) {\n      if (!file.meta.renderer) continue;\n      const renderer = this.renderers.get(file.meta.renderer);\n      if (!renderer) continue;\n      results.push(renderer.render(file, meta));\n    }\n    return results;\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@hey-api/codegen-core",
+  "version": "0.0.1",
+  "description": "🧱 TypeScript framework for generating structured, multi-file source code from abstract syntax trees.",
+  "homepage": "https://heyapi.dev/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hey-api/openapi-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hey-api/openapi-ts/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "email": "lubos@heyapi.dev",
+    "name": "Hey API",
+    "url": "https://heyapi.dev"
+  },
+  "funding": "https://github.com/sponsors/hey-api",
+  "keywords": [
+    "codegen",
+    "generator",
+    "javascript",
+    "node",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE.md"
+  ],
+  "engines": {
+    "node": "^18.18.0 || ^20.9.0 || >=22.10.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.5.3"
+  },
+  "devDependencies": {
+    "eslint": "9.17.0",
+    "prettier": "3.4.2",
+    "typescript": "5.8.3",
+    "@config/vite-base": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsup && pnpm check-exports",
+    "check-exports": "attw --pack . --profile node16",
+    "dev": "tsup --watch",
+    "test:coverage": "vitest run --coverage",
+    "test:update": "vitest watch --update",
+    "test:watch": "vitest watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}