@zeus-js/component-dts 0.1.1-beta.1 → 0.1.1-beta.3

package/dist/component-dts.cjs

@@ -1,5 +1,5 @@
 /**
-* component-dts v0.1.1-beta.1
+* component-dts v0.1.1-beta.3
 * (c) 2026 baicie
 * Released under the MIT License.
 **/
@@ -29,11 +29,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
+let _zeus_js_component_analyzer = require("@zeus-js/component-analyzer");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 //#region packages/web-c/component-dts/src/formatType.ts
 function formatPropType(prop) {
 	var _prop$values;
+	if (prop.declaration) {
+		var _prop$declaration$ref;
+		return (_prop$declaration$ref = prop.declaration.reference) !== null && _prop$declaration$ref !== void 0 ? _prop$declaration$ref : prop.declaration.type;
+	}
 	if ((_prop$values = prop.values) === null || _prop$values === void 0 ? void 0 : _prop$values.length) return prop.values.map((value) => JSON.stringify(value)).join(" | ");
 	switch (prop.type) {
 		case "string": return "string";
@@ -64,6 +69,7 @@ function normalizeKnownType(type) {
 		case "FocusEvent":
 		case "InputEvent":
 		case "Event": return type;
+		case "function": return "Function";
 		case "object": return "Record<string, unknown>";
 		case "array": return "unknown[]";
 		default: return type || "unknown";
@@ -100,6 +106,26 @@ function getEventMapTypeName(component) {
 function getPropsTypeName(component) {
 	return `${component.name}Props`;
 }
+function getGeneratedDeclarationNames(components) {
+	const names = new Set(_zeus_js_component_analyzer.PORTABLE_GLOBAL_TYPE_REFERENCES);
+	names.add("HTMLElementTagNameMap");
+	names.add("JSX");
+	names.add("React");
+	names.add("DefineComponent");
+	names.add("GlobalComponents");
+	for (const component of components) {
+		const elementTypeName = getElementTypeName(component);
+		names.add(component.name);
+		names.add(component.exportName);
+		names.add(elementTypeName);
+		names.add(`${elementTypeName}Props`);
+		names.add(`${elementTypeName}Methods`);
+		names.add(`${elementTypeName}EventTarget`);
+		names.add(getEventMapTypeName(component));
+		names.add(getPropsTypeName(component));
+	}
+	return names;
+}
 function getComponentFileBaseName(tag, options) {
 	if (options.fileName) return sanitizeFileName(options.fileName(tag)).replace(/\.d\.ts$/, "");
 	let name = tag;
@@ -161,18 +187,102 @@ function generateEventTargetType(elementTypeName, eventTargetTypeName, eventMapT
 	return lines.join("\n");
 }
 //#endregion
+//#region packages/web-c/component-dts/src/generatePropTypeDeclarations.ts
+function generatePropTypeDeclarations(components, options = {}) {
+	const declarations = /* @__PURE__ */ new Map();
+	const conflicts = /* @__PURE__ */ new Set();
+	for (const component of components) for (const prop of Object.values(component.props)) {
+		const declaration = prop.declaration;
+		const reference = declaration === null || declaration === void 0 ? void 0 : declaration.reference;
+		if (!reference) continue;
+		const existing = declarations.get(reference);
+		if (existing && existing !== declaration.type) {
+			conflicts.add(reference);
+			continue;
+		}
+		declarations.set(reference, declaration.type);
+	}
+	for (const reference of conflicts) declarations.delete(reference);
+	const allocatedNames = allocateDeclarationNames(declarations.keys(), options.reservedNames);
+	const normalizedComponents = components.map((component) => normalizeDeclarations(component, conflicts, allocatedNames));
+	const declarationPrefix = options.exported === false ? "type" : "export type";
+	return {
+		code: Array.from(declarations, ([name, type]) => {
+			return `${declarationPrefix} ${allocatedNames.get(name)} = ${type}`;
+		}).join("\n"),
+		components: normalizedComponents
+	};
+}
+function allocateDeclarationNames(references, reservedNames) {
+	const sourceNames = Array.from(references);
+	const used = new Set(reservedNames);
+	const result = /* @__PURE__ */ new Map();
+	for (const name of sourceNames) if (!used.has(name)) used.add(name);
+	for (const name of sourceNames) {
+		if (!(reservedNames === null || reservedNames === void 0 ? void 0 : reservedNames.has(name))) {
+			result.set(name, name);
+			continue;
+		}
+		const base = `${name}PropType`;
+		let candidate = base;
+		let suffix = 2;
+		while (used.has(candidate)) {
+			candidate = `${base}${suffix}`;
+			suffix += 1;
+		}
+		used.add(candidate);
+		result.set(name, candidate);
+	}
+	return result;
+}
+function normalizeDeclarations(component, conflicts, allocatedNames) {
+	let changed = false;
+	const props = Object.fromEntries(Object.entries(component.props).map(([name, prop]) => {
+		const declaration = prop.declaration;
+		if (!(declaration === null || declaration === void 0 ? void 0 : declaration.reference)) return [name, prop];
+		const reference = declaration.reference;
+		const allocatedName = allocatedNames.get(reference);
+		if (!conflicts.has(reference) && allocatedName === reference) return [name, prop];
+		changed = true;
+		return [name, {
+			...prop,
+			declaration: conflicts.has(reference) ? { type: declaration.type } : {
+				...declaration,
+				reference: allocatedName
+			}
+		}];
+	}));
+	return changed ? {
+		...component,
+		props
+	} : component;
+}
+//#endregion
 //#region packages/web-c/component-dts/src/generateWcDts.ts
 function generateComponentWCDts(component) {
-	const elementTypeName = getElementTypeName(component);
+	return generateComponentWCDtsFile(component);
+}
+function generateComponentWCDtsFile(component, options = {}) {
+	var _options$exportPropTy, _propTypeDeclarations;
+	const propTypeDeclarations = generatePropTypeDeclarations([component], {
+		exported: (_options$exportPropTy = options.exportPropTypes) !== null && _options$exportPropTy !== void 0 ? _options$exportPropTy : true,
+		reservedNames: mergeReservedNames(getGeneratedDeclarationNames([component]), options.reservedNames)
+	});
+	const resolvedComponent = (_propTypeDeclarations = propTypeDeclarations.components[0]) !== null && _propTypeDeclarations !== void 0 ? _propTypeDeclarations : component;
+	const elementTypeName = getElementTypeName(resolvedComponent);
 	const lines = [];
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	lines.push(generateEventMap(component));
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	lines.push(generateEventMap(resolvedComponent));
 	lines.push("");
-	lines.push(generateElementInterface(component));
+	lines.push(generateElementInterface(resolvedComponent));
 	lines.push("");
-	lines.push(`export declare const ${component.exportName}: {`);
+	lines.push(`export declare const ${resolvedComponent.exportName}: {`);
 	lines.push(`  new (): ${elementTypeName}`);
 	lines.push("}");
 	lines.push("");
@@ -184,7 +294,11 @@ function generateWCIndexDts(manifest, options) {
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
 	for (const component of manifest.components) lines.push(`import type { ${getElementTypeName(component)} } from ${JSON.stringify(options.getComponentImportPath(component))}`);
-	for (const component of manifest.components) lines.push(`export * from ${JSON.stringify(options.getComponentImportPath(component))}`);
+	for (const component of manifest.components) {
+		const importPath = JSON.stringify(options.getComponentImportPath(component));
+		lines.push(`export { ${component.exportName} } from ${importPath}`);
+		lines.push(`export type { ${getElementTypeName(component)}, ${getEventMapTypeName(component)} } from ${importPath}`);
+	}
 	lines.push("");
 	lines.push("declare global {");
 	lines.push("  interface HTMLElementTagNameMap {");
@@ -213,6 +327,9 @@ function generateElementInterface(component) {
 function toKebabCase$1(value) {
 	return value.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
 }
+function mergeReservedNames(defaults, additional) {
+	return /* @__PURE__ */ new Set([...defaults, ...additional !== null && additional !== void 0 ? additional : []]);
+}
 //#endregion
 //#region packages/web-c/component-dts/src/generateJsxDts.ts
 function generateWCJsxDts(manifest) {
@@ -220,7 +337,14 @@ function generateWCJsxDts(manifest) {
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("JSX");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateComponentJsxProps(component));
 		lines.push("");
 	}
@@ -276,7 +400,14 @@ function generateReactDts(manifest, options = {}) {
 	lines.push("");
 	lines.push(`import type * as React from 'react'`);
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("React");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateReactComponentDts(component, options));
 		lines.push("");
 	}
@@ -326,7 +457,14 @@ function generateVueDts(manifest) {
 	lines.push("");
 	lines.push(`import type { DefineComponent } from 'vue'`);
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("DefineComponent");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateVueComponentDts(component));
 		lines.push("");
 	}
@@ -397,9 +535,14 @@ function toKebabCase(value) {
 function generateWCDtsFiles(manifest, options = {}) {
 	const normalized = normalizeOptions(options);
 	const files = [];
-	if (normalized.perComponent) for (const component of manifest.components) files.push({
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	const resolvedComponents = generatePropTypeDeclarations(manifest.components, { reservedNames }).components;
+	if (normalized.perComponent) for (const component of resolvedComponents) files.push({
 		fileName: node_path.default.posix.join(normalized.outDir, getComponentDtsFileName(component.tag, normalized)),
-		source: generateComponentWCDts(component)
+		source: generateComponentWCDtsFile(component, {
+			exportPropTypes: false,
+			reservedNames
+		})
 	});
 	if (normalized.index) files.push({
 		fileName: node_path.default.posix.join(normalized.outDir, "index.d.ts"),
@@ -429,7 +572,12 @@ function generateLoaderDts(manifest) {
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	for (const component of manifest.components) {
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames: getGeneratedDeclarationNames(manifest.components) });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateElementType(component, {
 			componentOnReady: true,
 			forcePromise: true

package/dist/component-dts.esm-bundler.js

@@ -1,12 +1,17 @@
 /**
-* component-dts v0.1.1-beta.1
+* component-dts v0.1.1-beta.3
 * (c) 2026 baicie
 * Released under the MIT License.
 **/
+import { PORTABLE_GLOBAL_TYPE_REFERENCES } from "@zeus-js/component-analyzer";
 import path from "node:path";
 //#region packages/web-c/component-dts/src/formatType.ts
 function formatPropType(prop) {
 	var _prop$values;
+	if (prop.declaration) {
+		var _prop$declaration$ref;
+		return (_prop$declaration$ref = prop.declaration.reference) !== null && _prop$declaration$ref !== void 0 ? _prop$declaration$ref : prop.declaration.type;
+	}
 	if ((_prop$values = prop.values) === null || _prop$values === void 0 ? void 0 : _prop$values.length) return prop.values.map((value) => JSON.stringify(value)).join(" | ");
 	switch (prop.type) {
 		case "string": return "string";
@@ -37,6 +42,7 @@ function normalizeKnownType(type) {
 		case "FocusEvent":
 		case "InputEvent":
 		case "Event": return type;
+		case "function": return "Function";
 		case "object": return "Record<string, unknown>";
 		case "array": return "unknown[]";
 		default: return type || "unknown";
@@ -73,6 +79,26 @@ function getEventMapTypeName(component) {
 function getPropsTypeName(component) {
 	return `${component.name}Props`;
 }
+function getGeneratedDeclarationNames(components) {
+	const names = new Set(PORTABLE_GLOBAL_TYPE_REFERENCES);
+	names.add("HTMLElementTagNameMap");
+	names.add("JSX");
+	names.add("React");
+	names.add("DefineComponent");
+	names.add("GlobalComponents");
+	for (const component of components) {
+		const elementTypeName = getElementTypeName(component);
+		names.add(component.name);
+		names.add(component.exportName);
+		names.add(elementTypeName);
+		names.add(`${elementTypeName}Props`);
+		names.add(`${elementTypeName}Methods`);
+		names.add(`${elementTypeName}EventTarget`);
+		names.add(getEventMapTypeName(component));
+		names.add(getPropsTypeName(component));
+	}
+	return names;
+}
 function getComponentFileBaseName(tag, options) {
 	if (options.fileName) return sanitizeFileName(options.fileName(tag)).replace(/\.d\.ts$/, "");
 	let name = tag;
@@ -134,18 +160,154 @@ function generateEventTargetType(elementTypeName, eventTargetTypeName, eventMapT
 	return lines.join("\n");
 }
 //#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r) {
+			return Object.getOwnPropertyDescriptor(e, r).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
+			_defineProperty(e, r, t[r]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
+			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+		});
+	}
+	return e;
+}
+//#endregion
+//#region packages/web-c/component-dts/src/generatePropTypeDeclarations.ts
+function generatePropTypeDeclarations(components, options = {}) {
+	const declarations = /* @__PURE__ */ new Map();
+	const conflicts = /* @__PURE__ */ new Set();
+	for (const component of components) for (const prop of Object.values(component.props)) {
+		const declaration = prop.declaration;
+		const reference = declaration === null || declaration === void 0 ? void 0 : declaration.reference;
+		if (!reference) continue;
+		const existing = declarations.get(reference);
+		if (existing && existing !== declaration.type) {
+			conflicts.add(reference);
+			continue;
+		}
+		declarations.set(reference, declaration.type);
+	}
+	for (const reference of conflicts) declarations.delete(reference);
+	const allocatedNames = allocateDeclarationNames(declarations.keys(), options.reservedNames);
+	const normalizedComponents = components.map((component) => normalizeDeclarations(component, conflicts, allocatedNames));
+	const declarationPrefix = options.exported === false ? "type" : "export type";
+	return {
+		code: Array.from(declarations, ([name, type]) => {
+			return `${declarationPrefix} ${allocatedNames.get(name)} = ${type}`;
+		}).join("\n"),
+		components: normalizedComponents
+	};
+}
+function allocateDeclarationNames(references, reservedNames) {
+	const sourceNames = Array.from(references);
+	const used = new Set(reservedNames);
+	const result = /* @__PURE__ */ new Map();
+	for (const name of sourceNames) if (!used.has(name)) used.add(name);
+	for (const name of sourceNames) {
+		if (!(reservedNames === null || reservedNames === void 0 ? void 0 : reservedNames.has(name))) {
+			result.set(name, name);
+			continue;
+		}
+		const base = `${name}PropType`;
+		let candidate = base;
+		let suffix = 2;
+		while (used.has(candidate)) {
+			candidate = `${base}${suffix}`;
+			suffix += 1;
+		}
+		used.add(candidate);
+		result.set(name, candidate);
+	}
+	return result;
+}
+function normalizeDeclarations(component, conflicts, allocatedNames) {
+	let changed = false;
+	const props = Object.fromEntries(Object.entries(component.props).map(([name, prop]) => {
+		const declaration = prop.declaration;
+		if (!(declaration === null || declaration === void 0 ? void 0 : declaration.reference)) return [name, prop];
+		const reference = declaration.reference;
+		const allocatedName = allocatedNames.get(reference);
+		if (!conflicts.has(reference) && allocatedName === reference) return [name, prop];
+		changed = true;
+		return [name, _objectSpread2(_objectSpread2({}, prop), {}, { declaration: conflicts.has(reference) ? { type: declaration.type } : _objectSpread2(_objectSpread2({}, declaration), {}, { reference: allocatedName }) })];
+	}));
+	return changed ? _objectSpread2(_objectSpread2({}, component), {}, { props }) : component;
+}
+//#endregion
 //#region packages/web-c/component-dts/src/generateWcDts.ts
 function generateComponentWCDts(component) {
-	const elementTypeName = getElementTypeName(component);
+	return generateComponentWCDtsFile(component);
+}
+function generateComponentWCDtsFile(component, options = {}) {
+	var _options$exportPropTy, _propTypeDeclarations;
+	const propTypeDeclarations = generatePropTypeDeclarations([component], {
+		exported: (_options$exportPropTy = options.exportPropTypes) !== null && _options$exportPropTy !== void 0 ? _options$exportPropTy : true,
+		reservedNames: mergeReservedNames(getGeneratedDeclarationNames([component]), options.reservedNames)
+	});
+	const resolvedComponent = (_propTypeDeclarations = propTypeDeclarations.components[0]) !== null && _propTypeDeclarations !== void 0 ? _propTypeDeclarations : component;
+	const elementTypeName = getElementTypeName(resolvedComponent);
 	const lines = [];
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	lines.push(generateEventMap(component));
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	lines.push(generateEventMap(resolvedComponent));
 	lines.push("");
-	lines.push(generateElementInterface(component));
+	lines.push(generateElementInterface(resolvedComponent));
 	lines.push("");
-	lines.push(`export declare const ${component.exportName}: {`);
+	lines.push(`export declare const ${resolvedComponent.exportName}: {`);
 	lines.push(`  new (): ${elementTypeName}`);
 	lines.push("}");
 	lines.push("");
@@ -157,7 +319,11 @@ function generateWCIndexDts(manifest, options) {
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
 	for (const component of manifest.components) lines.push(`import type { ${getElementTypeName(component)} } from ${JSON.stringify(options.getComponentImportPath(component))}`);
-	for (const component of manifest.components) lines.push(`export * from ${JSON.stringify(options.getComponentImportPath(component))}`);
+	for (const component of manifest.components) {
+		const importPath = JSON.stringify(options.getComponentImportPath(component));
+		lines.push(`export { ${component.exportName} } from ${importPath}`);
+		lines.push(`export type { ${getElementTypeName(component)}, ${getEventMapTypeName(component)} } from ${importPath}`);
+	}
 	lines.push("");
 	lines.push("declare global {");
 	lines.push("  interface HTMLElementTagNameMap {");
@@ -186,6 +352,9 @@ function generateElementInterface(component) {
 function toKebabCase$1(value) {
 	return value.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
 }
+function mergeReservedNames(defaults, additional) {
+	return /* @__PURE__ */ new Set([...defaults, ...additional !== null && additional !== void 0 ? additional : []]);
+}
 //#endregion
 //#region packages/web-c/component-dts/src/generateJsxDts.ts
 function generateWCJsxDts(manifest) {
@@ -193,7 +362,14 @@ function generateWCJsxDts(manifest) {
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("JSX");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateComponentJsxProps(component));
 		lines.push("");
 	}
@@ -249,7 +425,14 @@ function generateReactDts(manifest, options = {}) {
 	lines.push("");
 	lines.push(`import type * as React from 'react'`);
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("React");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateReactComponentDts(component, options));
 		lines.push("");
 	}
@@ -299,7 +482,14 @@ function generateVueDts(manifest) {
 	lines.push("");
 	lines.push(`import type { DefineComponent } from 'vue'`);
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("DefineComponent");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateVueComponentDts(component));
 		lines.push("");
 	}
@@ -370,9 +560,14 @@ function toKebabCase(value) {
 function generateWCDtsFiles(manifest, options = {}) {
 	const normalized = normalizeOptions(options);
 	const files = [];
-	if (normalized.perComponent) for (const component of manifest.components) files.push({
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	const resolvedComponents = generatePropTypeDeclarations(manifest.components, { reservedNames }).components;
+	if (normalized.perComponent) for (const component of resolvedComponents) files.push({
 		fileName: path.posix.join(normalized.outDir, getComponentDtsFileName(component.tag, normalized)),
-		source: generateComponentWCDts(component)
+		source: generateComponentWCDtsFile(component, {
+			exportPropTypes: false,
+			reservedNames
+		})
 	});
 	if (normalized.index) files.push({
 		fileName: path.posix.join(normalized.outDir, "index.d.ts"),
@@ -402,7 +597,12 @@ function generateLoaderDts(manifest) {
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	for (const component of manifest.components) {
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames: getGeneratedDeclarationNames(manifest.components) });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateElementType(component, {
 			componentOnReady: true,
 			forcePromise: true

package/dist/component-dts.prod.cjs

@@ -1,5 +1,5 @@
 /**
-* component-dts v0.1.1-beta.1
+* component-dts v0.1.1-beta.3
 * (c) 2026 baicie
 * Released under the MIT License.
 **/
@@ -29,11 +29,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
+let _zeus_js_component_analyzer = require("@zeus-js/component-analyzer");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 //#region packages/web-c/component-dts/src/formatType.ts
 function formatPropType(prop) {
 	var _prop$values;
+	if (prop.declaration) {
+		var _prop$declaration$ref;
+		return (_prop$declaration$ref = prop.declaration.reference) !== null && _prop$declaration$ref !== void 0 ? _prop$declaration$ref : prop.declaration.type;
+	}
 	if ((_prop$values = prop.values) === null || _prop$values === void 0 ? void 0 : _prop$values.length) return prop.values.map((value) => JSON.stringify(value)).join(" | ");
 	switch (prop.type) {
 		case "string": return "string";
@@ -64,6 +69,7 @@ function normalizeKnownType(type) {
 		case "FocusEvent":
 		case "InputEvent":
 		case "Event": return type;
+		case "function": return "Function";
 		case "object": return "Record<string, unknown>";
 		case "array": return "unknown[]";
 		default: return type || "unknown";
@@ -100,6 +106,26 @@ function getEventMapTypeName(component) {
 function getPropsTypeName(component) {
 	return `${component.name}Props`;
 }
+function getGeneratedDeclarationNames(components) {
+	const names = new Set(_zeus_js_component_analyzer.PORTABLE_GLOBAL_TYPE_REFERENCES);
+	names.add("HTMLElementTagNameMap");
+	names.add("JSX");
+	names.add("React");
+	names.add("DefineComponent");
+	names.add("GlobalComponents");
+	for (const component of components) {
+		const elementTypeName = getElementTypeName(component);
+		names.add(component.name);
+		names.add(component.exportName);
+		names.add(elementTypeName);
+		names.add(`${elementTypeName}Props`);
+		names.add(`${elementTypeName}Methods`);
+		names.add(`${elementTypeName}EventTarget`);
+		names.add(getEventMapTypeName(component));
+		names.add(getPropsTypeName(component));
+	}
+	return names;
+}
 function getComponentFileBaseName(tag, options) {
 	if (options.fileName) return sanitizeFileName(options.fileName(tag)).replace(/\.d\.ts$/, "");
 	let name = tag;
@@ -161,18 +187,102 @@ function generateEventTargetType(elementTypeName, eventTargetTypeName, eventMapT
 	return lines.join("\n");
 }
 //#endregion
+//#region packages/web-c/component-dts/src/generatePropTypeDeclarations.ts
+function generatePropTypeDeclarations(components, options = {}) {
+	const declarations = /* @__PURE__ */ new Map();
+	const conflicts = /* @__PURE__ */ new Set();
+	for (const component of components) for (const prop of Object.values(component.props)) {
+		const declaration = prop.declaration;
+		const reference = declaration === null || declaration === void 0 ? void 0 : declaration.reference;
+		if (!reference) continue;
+		const existing = declarations.get(reference);
+		if (existing && existing !== declaration.type) {
+			conflicts.add(reference);
+			continue;
+		}
+		declarations.set(reference, declaration.type);
+	}
+	for (const reference of conflicts) declarations.delete(reference);
+	const allocatedNames = allocateDeclarationNames(declarations.keys(), options.reservedNames);
+	const normalizedComponents = components.map((component) => normalizeDeclarations(component, conflicts, allocatedNames));
+	const declarationPrefix = options.exported === false ? "type" : "export type";
+	return {
+		code: Array.from(declarations, ([name, type]) => {
+			return `${declarationPrefix} ${allocatedNames.get(name)} = ${type}`;
+		}).join("\n"),
+		components: normalizedComponents
+	};
+}
+function allocateDeclarationNames(references, reservedNames) {
+	const sourceNames = Array.from(references);
+	const used = new Set(reservedNames);
+	const result = /* @__PURE__ */ new Map();
+	for (const name of sourceNames) if (!used.has(name)) used.add(name);
+	for (const name of sourceNames) {
+		if (!(reservedNames === null || reservedNames === void 0 ? void 0 : reservedNames.has(name))) {
+			result.set(name, name);
+			continue;
+		}
+		const base = `${name}PropType`;
+		let candidate = base;
+		let suffix = 2;
+		while (used.has(candidate)) {
+			candidate = `${base}${suffix}`;
+			suffix += 1;
+		}
+		used.add(candidate);
+		result.set(name, candidate);
+	}
+	return result;
+}
+function normalizeDeclarations(component, conflicts, allocatedNames) {
+	let changed = false;
+	const props = Object.fromEntries(Object.entries(component.props).map(([name, prop]) => {
+		const declaration = prop.declaration;
+		if (!(declaration === null || declaration === void 0 ? void 0 : declaration.reference)) return [name, prop];
+		const reference = declaration.reference;
+		const allocatedName = allocatedNames.get(reference);
+		if (!conflicts.has(reference) && allocatedName === reference) return [name, prop];
+		changed = true;
+		return [name, {
+			...prop,
+			declaration: conflicts.has(reference) ? { type: declaration.type } : {
+				...declaration,
+				reference: allocatedName
+			}
+		}];
+	}));
+	return changed ? {
+		...component,
+		props
+	} : component;
+}
+//#endregion
 //#region packages/web-c/component-dts/src/generateWcDts.ts
 function generateComponentWCDts(component) {
-	const elementTypeName = getElementTypeName(component);
+	return generateComponentWCDtsFile(component);
+}
+function generateComponentWCDtsFile(component, options = {}) {
+	var _options$exportPropTy, _propTypeDeclarations;
+	const propTypeDeclarations = generatePropTypeDeclarations([component], {
+		exported: (_options$exportPropTy = options.exportPropTypes) !== null && _options$exportPropTy !== void 0 ? _options$exportPropTy : true,
+		reservedNames: mergeReservedNames(getGeneratedDeclarationNames([component]), options.reservedNames)
+	});
+	const resolvedComponent = (_propTypeDeclarations = propTypeDeclarations.components[0]) !== null && _propTypeDeclarations !== void 0 ? _propTypeDeclarations : component;
+	const elementTypeName = getElementTypeName(resolvedComponent);
 	const lines = [];
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	lines.push(generateEventMap(component));
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	lines.push(generateEventMap(resolvedComponent));
 	lines.push("");
-	lines.push(generateElementInterface(component));
+	lines.push(generateElementInterface(resolvedComponent));
 	lines.push("");
-	lines.push(`export declare const ${component.exportName}: {`);
+	lines.push(`export declare const ${resolvedComponent.exportName}: {`);
 	lines.push(`  new (): ${elementTypeName}`);
 	lines.push("}");
 	lines.push("");
@@ -184,7 +294,11 @@ function generateWCIndexDts(manifest, options) {
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
 	for (const component of manifest.components) lines.push(`import type { ${getElementTypeName(component)} } from ${JSON.stringify(options.getComponentImportPath(component))}`);
-	for (const component of manifest.components) lines.push(`export * from ${JSON.stringify(options.getComponentImportPath(component))}`);
+	for (const component of manifest.components) {
+		const importPath = JSON.stringify(options.getComponentImportPath(component));
+		lines.push(`export { ${component.exportName} } from ${importPath}`);
+		lines.push(`export type { ${getElementTypeName(component)}, ${getEventMapTypeName(component)} } from ${importPath}`);
+	}
 	lines.push("");
 	lines.push("declare global {");
 	lines.push("  interface HTMLElementTagNameMap {");
@@ -213,6 +327,9 @@ function generateElementInterface(component) {
 function toKebabCase$1(value) {
 	return value.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
 }
+function mergeReservedNames(defaults, additional) {
+	return /* @__PURE__ */ new Set([...defaults, ...additional !== null && additional !== void 0 ? additional : []]);
+}
 //#endregion
 //#region packages/web-c/component-dts/src/generateJsxDts.ts
 function generateWCJsxDts(manifest) {
@@ -220,7 +337,14 @@ function generateWCJsxDts(manifest) {
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("JSX");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateComponentJsxProps(component));
 		lines.push("");
 	}
@@ -276,7 +400,14 @@ function generateReactDts(manifest, options = {}) {
 	lines.push("");
 	lines.push(`import type * as React from 'react'`);
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("React");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateReactComponentDts(component, options));
 		lines.push("");
 	}
@@ -326,7 +457,14 @@ function generateVueDts(manifest) {
 	lines.push("");
 	lines.push(`import type { DefineComponent } from 'vue'`);
 	lines.push("");
-	for (const component of manifest.components) {
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	reservedNames.add("DefineComponent");
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateVueComponentDts(component));
 		lines.push("");
 	}
@@ -397,9 +535,14 @@ function toKebabCase(value) {
 function generateWCDtsFiles(manifest, options = {}) {
 	const normalized = normalizeOptions(options);
 	const files = [];
-	if (normalized.perComponent) for (const component of manifest.components) files.push({
+	const reservedNames = getGeneratedDeclarationNames(manifest.components);
+	const resolvedComponents = generatePropTypeDeclarations(manifest.components, { reservedNames }).components;
+	if (normalized.perComponent) for (const component of resolvedComponents) files.push({
 		fileName: node_path.default.posix.join(normalized.outDir, getComponentDtsFileName(component.tag, normalized)),
-		source: generateComponentWCDts(component)
+		source: generateComponentWCDtsFile(component, {
+			exportPropTypes: false,
+			reservedNames
+		})
 	});
 	if (normalized.index) files.push({
 		fileName: node_path.default.posix.join(normalized.outDir, "index.d.ts"),
@@ -429,7 +572,12 @@ function generateLoaderDts(manifest) {
 	lines.push("/* eslint-disable */");
 	lines.push("// Generated by @zeus-js/component-dts.");
 	lines.push("");
-	for (const component of manifest.components) {
+	const propTypeDeclarations = generatePropTypeDeclarations(manifest.components, { reservedNames: getGeneratedDeclarationNames(manifest.components) });
+	if (propTypeDeclarations.code) {
+		lines.push(propTypeDeclarations.code);
+		lines.push("");
+	}
+	for (const component of propTypeDeclarations.components) {
 		lines.push(generateElementType(component, {
 			componentOnReady: true,
 			forcePromise: true

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zeus-js/component-dts",
   "type": "module",
-  "version": "0.1.1-beta.1",
+  "version": "0.1.1-beta.3",
   "description": "DTS generators for Zeus component manifest",
   "license": "MIT",
   "repository": {
@@ -31,7 +31,7 @@
     "dist"
   ],
   "dependencies": {
-    "@zeus-js/component-analyzer": "0.1.1-beta.1"
+    "@zeus-js/component-analyzer": "0.1.1-beta.3"
   },
   "author": "Baicie",
   "buildOptions": {