@hey-api/codegen-core 0.8.4 → 0.9.1

package/dist/index.mjs

@@ -19,7 +19,9 @@ function detectInteractiveSession() {
 //#endregion
 //#region src/config/merge.ts
 function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
+	if (typeof value !== "object" || value === null) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
 }
 function mergeConfigs(configA, configB) {
 	const a = configA || {};
@@ -283,7 +285,8 @@ var File = class {
 	* Returns a debug‑friendly string representation identifying the file.
 	*/
 	toString() {
-		return `[File ${this._logicalFilePath}#${this.id}]`;
+		const finalPath = this._finalPath ? ` → ${this._finalPath}` : "";
+		return `${`${this._finalPath ? "✓" : "~"} `}File#${this.id} ${this._logicalFilePath}${finalPath}`;
 	}
 };
 //#endregion
@@ -542,10 +545,10 @@ var FileRegistry = class {
 * const r2 = ref(r); // { '~ref': 123 } (not double-wrapped)
 * ```
 */
-const ref = (value) => {
+function ref(value) {
 	if (isRef(value)) return value;
 	return { "~ref": value };
-};
+}
 /**
 * Converts a plain object to an object of Refs (deep, per property).
 *
@@ -555,11 +558,11 @@ const ref = (value) => {
 * const refs = refs(obj); // { a: { '~ref': 1 }, b: { '~ref': "x" } }
 * ```
 */
-const refs = (obj) => {
+function refs(obj) {
 	const result = {};
 	for (const key in obj) if (Object.prototype.hasOwnProperty.call(obj, key)) result[key] = ref(obj[key]);
 	return result;
-};
+}
 /**
 * Unwraps a single Ref object to its value.
 *
@@ -570,7 +573,9 @@ const refs = (obj) => {
 * console.log(n); // 42
 * ```
 */
-const fromRef = (ref) => ref?.["~ref"];
+function fromRef(ref) {
+	return ref?.["~ref"];
+}
 /**
 * Converts an object of Refs back to a plain object (unwraps all refs).
 *
@@ -580,18 +585,20 @@ const fromRef = (ref) => ref?.["~ref"];
 * const plain = fromRefs(refs); // { a: 1, b: "x" }
 * ```
 */
-const fromRefs = (obj) => {
+function fromRefs(obj) {
 	const result = {};
 	for (const key in obj) if (Object.prototype.hasOwnProperty.call(obj, key)) result[key] = fromRef(obj[key]);
 	return result;
-};
+}
 /**
 * Checks whether a value is a Ref object.
 *
 * @param value Value to check
 * @returns True if the value is a Ref object.
 */
-const isRef = (value) => typeof value === "object" && value !== null && "~ref" in value;
+function isRef(value) {
+	return typeof value === "object" && value !== null && "~ref" in value;
+}
 //#endregion
 //#region src/nodes/registry.ts
 var NodeRegistry = class {
@@ -664,17 +671,20 @@ function registerChildName(scope, name, kind) {
 //#endregion
 //#region src/planner/analyzer.ts
 var AnalysisContext = class {
+	/** Arbitrary project metadata. */
+	meta;
 	/**
 	* Stack of parent nodes during analysis.
 	*
 	* The top of the stack is the current semantic container.
 	*/
-	_parentStack = [];
+	parentStack = [];
 	scope;
 	scopes = createScope();
 	symbol;
-	constructor(node) {
-		this._parentStack.push(node);
+	constructor(node, meta) {
+		this.parentStack.push(node);
+		this.meta = meta;
 		this.scope = this.scopes;
 		this.symbol = node.symbol;
 	}
@@ -682,7 +692,7 @@ var AnalysisContext = class {
 	* Get the current semantic parent (top of stack).
 	*/
 	get currentParent() {
-		return this._parentStack[this._parentStack.length - 1];
+		return this.parentStack[this.parentStack.length - 1];
 	}
 	/**
 	* Register a child node under the current parent.
@@ -708,6 +718,7 @@ var AnalysisContext = class {
 			const node = fromRef(value);
 			this.addChild(node, "container");
 			this.pushParent(node);
+			node.meta = this.meta[node.language] ?? {};
 			node.analyze(this);
 			this.popParent();
 		}
@@ -736,7 +747,7 @@ var AnalysisContext = class {
 	* Call this when exiting a container node.
 	*/
 	popParent() {
-		this._parentStack.pop();
+		this.parentStack.pop();
 	}
 	popScope() {
 		this.scope = this.scope.parent ?? this.scope;
@@ -745,7 +756,7 @@ var AnalysisContext = class {
 	* Push a node as the current semantic parent.
 	*/
 	pushParent(node) {
-		this._parentStack.push(node);
+		this.parentStack.push(node);
 	}
 	pushScope() {
 		const scope = createScope({ parent: this.scope });
@@ -763,12 +774,17 @@ var AnalysisContext = class {
 	}
 };
 var Analyzer = class {
+	meta;
 	nodeCache = /* @__PURE__ */ new WeakMap();
+	constructor(meta) {
+		this.meta = meta;
+	}
 	analyzeNode(node) {
 		const cached = this.nodeCache.get(node);
 		if (cached) return cached;
 		node.root = true;
-		const ctx = new AnalysisContext(node);
+		node.meta = this.meta[node.language] ?? {};
+		const ctx = new AnalysisContext(node, this.meta);
 		node.analyze(ctx);
 		this.nodeCache.set(node, ctx);
 		return ctx;
@@ -783,21 +799,26 @@ var Analyzer = class {
 //#endregion
 //#region src/planner/planner.ts
 const isTypeOnlyKind = (kind) => kind === "type" || kind === "interface";
-var Planner = class {
-	analyzer = new Analyzer();
+var Planner = class Planner {
+	static MAX_ALLOCATION_ROUNDS = 100;
+	analyzer;
 	cacheResolvedNames = /* @__PURE__ */ new Set();
 	project;
 	constructor(project) {
+		this.analyzer = new Analyzer(project.meta);
 		this.project = project;
 	}
 	/**
 	* Executes the planning phase for the project.
 	*/
-	plan(meta) {
+	plan() {
 		this.cacheResolvedNames.clear();
-		this.allocateFiles();
-		this.assignLocalNames();
-		this.resolveFilePaths(meta);
+		let rounds = 0;
+		while (this.allocateFiles()) {
+			this.assignLocalNames();
+			if (++rounds > Planner.MAX_ALLOCATION_ROUNDS) throw new Error(`File allocation failed to converge after ${Planner.MAX_ALLOCATION_ROUNDS} rounds`);
+		}
+		this.resolveFilePaths();
 		this.planExports();
 		this.planImports();
 	}
@@ -806,21 +827,25 @@ var Planner = class {
 	* and external dependency.
 	*/
 	allocateFiles() {
+		let allocated = 0;
 		this.analyzer.analyze(this.project.nodes.all(), (ctx, node) => {
 			const symbol = node.symbol;
 			if (!symbol) return;
-			const file = this.project.files.register({
-				external: false,
-				language: node.language,
-				logicalFilePath: symbol.getFilePath?.(symbol) || this.project.defaultFileName
-			});
-			file.addNode(node);
-			symbol.setFile(file);
-			for (const logicalFilePath of symbol.getExportFromFilePath?.(symbol) ?? []) this.project.files.register({
-				external: false,
-				language: file.language,
-				logicalFilePath
-			});
+			if (!symbol.file) {
+				const file = this.project.files.register({
+					external: false,
+					language: node.language,
+					logicalFilePath: symbol.getFilePath?.(symbol) || this.project.defaultFileName
+				});
+				file.addNode(node);
+				symbol.setFile(file);
+				allocated++;
+				for (const logicalFilePath of symbol.getExportFromFilePath?.(symbol) ?? []) this.project.files.register({
+					external: false,
+					language: file.language,
+					logicalFilePath
+				});
+			}
 			ctx.walkScopes((dependency) => {
 				const dep = fromRef(dependency);
 				if (dep.external && dep.isCanonical && !dep.file) {
@@ -830,9 +855,11 @@ var Planner = class {
 						logicalFilePath: dep.external
 					});
 					dep.setFile(file);
+					allocated++;
 				}
 			});
 		});
+		return allocated;
 	}
 	/**
 	* Assigns final names to all symbols.
@@ -840,7 +867,11 @@ var Planner = class {
 	* First assigns top-level (file-scoped) symbol names, then local symbols.
 	*/
 	assignLocalNames() {
-		this.analyzer.analyze(this.project.nodes.all(), (ctx, node) => {
+		const sorted = [...this.project.nodes.all()].sort((a, b) => {
+			const pa = a.symbol?.priority ?? 0;
+			return (b.symbol?.priority ?? 0) - pa;
+		});
+		this.analyzer.analyze(sorted, (ctx, node) => {
 			const symbol = node.symbol;
 			if (!symbol) return;
 			this.assignTopLevelName({
@@ -854,7 +885,7 @@ var Planner = class {
 			if (!file) return;
 			ctx.walkScopes((dependency) => {
 				const dep = fromRef(dependency);
-				if (dep.file) return;
+				if (dep.file || dep.external) return;
 				this.assignLocalName({
 					ctx,
 					file,
@@ -871,7 +902,7 @@ var Planner = class {
 	*
 	* Resolves final paths relative to the project's root directory.
 	*/
-	resolveFilePaths(meta) {
+	resolveFilePaths() {
 		for (const file of this.project.files.registered()) {
 			if (file.external) {
 				file.setFinalPath(file.logicalFilePath);
@@ -883,7 +914,6 @@ var Planner = class {
 			if (finalPath) file.setFinalPath(path.resolve(this.project.root, finalPath));
 			const ctx = {
 				file,
-				meta,
 				project: this.project
 			};
 			const renderer = this.project.renderers.find((r) => r.supports(ctx));
@@ -1018,6 +1048,7 @@ var Planner = class {
 						symbol: imp
 					};
 					fileMap.set(key, entry);
+					dep.addImport(imp);
 				}
 				entry.kinds.add(dep.kind);
 				dependency["~ref"] = entry.symbol;
@@ -1203,12 +1234,24 @@ var Symbol = class {
 	*/
 	_importKind;
 	/**
+	* Per-file imported instances of this symbol.
+	*
+	* @default []
+	*/
+	_imports = [];
+	/**
 	* Kind of symbol (class, type, alias, etc.).
 	*
 	* @default 'var'
 	*/
 	_kind;
 	/**
+	* Registered event listeners keyed by event name.
+	*
+	* @default {}
+	*/
+	_listeners = {};
+	/**
 	* Arbitrary user metadata.
 	*
 	* @default undefined
@@ -1230,6 +1273,13 @@ var Symbol = class {
 	* @default false
 	*/
 	_override;
+	/**
+	* Naming priority. Higher value wins the canonical name when
+	* multiple symbols in the same file compete for the same identifier.
+	*
+	* @default 0
+	*/
+	_priority;
 	/** Brand used for identifying symbols. */
 	"~brand" = symbolBrand;
 	/** Globally unique, stable symbol ID. */
@@ -1246,6 +1296,7 @@ var Symbol = class {
 		this._meta = input.meta;
 		this._name = input.name;
 		this._override = input.override ?? false;
+		this._priority = input.priority ?? 0;
 	}
 	/**
 	* Returns the canonical symbol for this instance.
@@ -1313,12 +1364,24 @@ var Symbol = class {
 		return this.canonical._importKind;
 	}
 	/**
+	* Read-only accessor for the per-file imported instances of this symbol.
+	*/
+	get imports() {
+		return this.canonical._imports;
+	}
+	/**
 	* Indicates whether this is a canonical symbol (not a stub).
 	*/
 	get isCanonical() {
 		return !this._canonical || this._canonical === this;
 	}
 	/**
+	* Indicates whether this symbol was renamed during conflict resolution.
+	*/
+	get isRenamed() {
+		return Boolean(this.canonical._finalName) && this.canonical._finalName !== this.canonical._name;
+	}
+	/**
 	* The symbol's kind (class, type, alias, variable, etc.).
 	*/
 	get kind() {
@@ -1349,12 +1412,40 @@ var Symbol = class {
 		return this.canonical._override;
 	}
 	/**
+	* Naming priority. Higher value wins the canonical name when
+	* multiple symbols in the same file compete for the same identifier.
+	*/
+	get priority() {
+		return this.canonical._priority;
+	}
+	/**
+	* Registers a per-file imported instance of this symbol.
+	*
+	* @param symbol The imported instance to register.
+	*/
+	addImport(symbol) {
+		this.assertCanonical();
+		this._imports.push(symbol);
+		this.emit("import", { symbol });
+	}
+	/**
+	* Registers a listener for the given symbol lifecycle event.
+	*
+	* @param event The event to subscribe to.
+	* @param listener Callback invoked when the event is emitted.
+	* @returns `this` for chaining.
+	*/
+	on(event, listener) {
+		(this.canonical._listeners[event] ??= []).push(listener);
+		return this;
+	}
+	/**
 	* Marks this symbol as a stub and assigns its canonical symbol.
 	*
 	* After calling this, all semantic queries (name, kind, file,
 	* meta, etc.) should reflect the canonical symbol's values.
 	*
-	* @param symbol — The canonical symbol this stub should resolve to.
+	* @param symbol The canonical symbol this stub should resolve to.
 	*/
 	setCanonical(symbol) {
 		this._canonical = symbol;
@@ -1362,7 +1453,7 @@ var Symbol = class {
 	/**
 	* Assigns the child symbol bindings associated with this symbol.
 	*
-	* @param children — Child bindings to associate with the symbol.
+	* @param children Child bindings to associate with the symbol.
 	*/
 	setChildren(children) {
 		this.assertCanonical();
@@ -1371,7 +1462,7 @@ var Symbol = class {
 	/**
 	* Marks the symbol as exported from its file.
 	*
-	* @param exported — Whether the symbol is exported.
+	* @param exported Whether the symbol is exported.
 	*/
 	setExported(exported) {
 		this.assertCanonical();
@@ -1390,6 +1481,10 @@ var Symbol = class {
 			throw new Error(message);
 		}
 		this._file = file;
+		this.emit("file", {
+			file,
+			symbol: this
+		});
 	}
 	/**
 	* Assigns the conflict‑resolved final local name for this symbol.
@@ -1404,11 +1499,15 @@ var Symbol = class {
 			throw new Error(message);
 		}
 		this._finalName = name;
+		this.emit("finalName", {
+			finalName: name,
+			symbol: this
+		});
 	}
 	/**
 	* Sets how this symbol should be imported.
 	*
-	* @param kind — The import strategy (named/default/namespace).
+	* @param kind The import strategy (named/default/namespace).
 	*/
 	setImportKind(kind) {
 		this.assertCanonical();
@@ -1417,7 +1516,7 @@ var Symbol = class {
 	/**
 	* Sets the symbol's kind (class, type, alias, variable, etc.).
 	*
-	* @param kind — The new symbol kind.
+	* @param kind The new symbol kind.
 	*/
 	setKind(kind) {
 		this.assertCanonical();
@@ -1426,7 +1525,7 @@ var Symbol = class {
 	/**
 	* Updates the intended user‑facing name for this symbol.
 	*
-	* @param name — The new name.
+	* @param name The new name.
 	*/
 	setName(name) {
 		this.assertCanonical();
@@ -1449,7 +1548,7 @@ var Symbol = class {
 	/**
 	* Marks whether this symbol should be treated as an override.
 	*
-	* @param override — Override marker value.
+	* @param override Override marker value.
 	*/
 	setOverride(override) {
 		this.assertCanonical();
@@ -1459,9 +1558,15 @@ var Symbol = class {
 	* Returns a debug‑friendly string representation identifying the symbol.
 	*/
 	toString() {
-		const canonical = this.canonical;
-		if (canonical._finalName) return `[Symbol ${canonical._name} → ${canonical._finalName}#${canonical.id}]`;
-		return `[Symbol ${canonical._name}#${canonical.id}] ${JSON.stringify(canonical._meta ?? {})}`;
+		const c = this.canonical;
+		const status = `${this._finalName ? "✓" : "~"} `;
+		let renamed = "";
+		let file = "";
+		if (c._finalName) {
+			renamed = c._finalName !== c._name ? ` → "${c._finalName}"` : "";
+			file = c._file ? ` ${c._file.logicalFilePath}` : "";
+		}
+		return `${status}Symbol#${c.id} "${c._name}"${renamed}${file}`;
 	}
 	/**
 	* Ensures this symbol is canonical before allowing mutation.
@@ -1480,6 +1585,17 @@ var Symbol = class {
 			throw new Error(message);
 		}
 	}
+	/**
+	* Invokes all registered listeners for the given event.
+	*
+	* @param event The event to emit.
+	* @param args Arguments forwarded to each listener.
+	*/
+	emit(event, ...args) {
+		const listeners = this._listeners[event];
+		if (!listeners) return;
+		for (const listener of listeners) listener(...args);
+	}
 };
 //#endregion
 //#region src/symbols/registry.ts
@@ -1653,6 +1769,7 @@ var SymbolRegistry = class {
 var Project = class {
 	_isPlanned = false;
 	files;
+	meta;
 	nodes = new NodeRegistry();
 	symbols = new SymbolRegistry();
 	defaultFileName;
@@ -1664,6 +1781,7 @@ var Project = class {
 	renderers;
 	root;
 	constructor(args) {
+		this.meta = args.meta ?? {};
 		const fileName = args.fileName;
 		this.defaultFileName = args.defaultFileName ?? "main";
 		this.defaultNameConflictResolver = args.defaultNameConflictResolver ?? simpleNameConflictResolver;
@@ -1684,18 +1802,17 @@ var Project = class {
 		this.renderers = args.renderers ?? [];
 		this.root = path.resolve(args.root).replace(/[/\\]+$/, "");
 	}
-	plan(meta) {
+	plan() {
 		if (this._isPlanned) return;
-		new Planner(this).plan(meta);
+		new Planner(this).plan();
 		this._isPlanned = true;
 	}
-	render(meta) {
-		if (!this._isPlanned) this.plan(meta);
+	render() {
+		if (!this._isPlanned) this.plan();
 		const files = [];
 		for (const file of this.files.registered()) if (!file.external && file.finalPath && file.renderer) {
 			const content = file.renderer.render({
 				file,
-				meta,
 				project: this
 			});
 			files.push({
@@ -1842,6 +1959,48 @@ var StructureModel = class {
 	}
 };
 //#endregion
-export { File, Logger, Project, StructureModel, StructureNode, Symbol, defaultExtensions, defaultModuleEntryNames, defaultNameConflictResolvers, detectInteractiveSession, fromRef, fromRefs, isNode, isNodeRef, isRef, isSymbol, isSymbolRef, loadConfigFile, log, mergeConfigs, nodeBrand, pythonNameConflictResolver, ref, refs, simpleNameConflictResolver, symbolBrand, underscoreNameConflictResolver };
+//#region src/version.ts
+var Version = class Version {
+	_segments;
+	raw;
+	constructor(version) {
+		this.raw = version;
+		this._segments = version.split(".").map((segment) => {
+			const num = Number.parseInt(segment, 10);
+			if (Number.isNaN(num)) throw new Error(`Invalid version segment "${segment}" in "${version}"`);
+			return num;
+		});
+	}
+	_compare(other) {
+		const b = other instanceof Version ? other : new Version(other);
+		const len = Math.max(this._segments.length, b._segments.length);
+		for (let i = 0; i < len; i++) {
+			const a = this._segments[i] ?? 0;
+			const bSeg = b._segments[i] ?? 0;
+			if (a !== bSeg) return a - bSeg;
+		}
+		return 0;
+	}
+	eq(other) {
+		return this._compare(other) === 0;
+	}
+	gt(other) {
+		return this._compare(other) > 0;
+	}
+	gte(other) {
+		return this._compare(other) >= 0;
+	}
+	lt(other) {
+		return this._compare(other) < 0;
+	}
+	lte(other) {
+		return this._compare(other) <= 0;
+	}
+	toString() {
+		return this.raw;
+	}
+};
+//#endregion
+export { File, Logger, Project, StructureModel, StructureNode, Symbol, Version, defaultExtensions, defaultModuleEntryNames, defaultNameConflictResolvers, detectInteractiveSession, fromRef, fromRefs, isNode, isNodeRef, isRef, isSymbol, isSymbolRef, loadConfigFile, log, mergeConfigs, nodeBrand, pythonNameConflictResolver, ref, refs, simpleNameConflictResolver, symbolBrand, underscoreNameConflictResolver };
 
 //# sourceMappingURL=index.mjs.map