ExternsGenerators: Add includedSymbols

Author: Fancy2209

.gitignore

@@ -33,6 +33,17 @@ lib-esm/_gen/
 lib/**/*.as
 lib/**/*.d.ts
 !lib/**/index.d.ts
+!lib/flash/display/ShaderData.as 
+!lib/flash/net/navigateToURL.as 
+!lib/flash/net/sendToURL.as 
+!lib/flash/net/URLVariables.as 
+!lib/flash/utils/clearTimeout.as 
+!lib/flash/utils/Dictionary.as  
+!lib/flash/utils/getDefinitionByName.as 
+!lib/flash/utils/getQualifiedClassName.as 
+!lib/flash/utils/getQualifiedSuperclassName.as 
+!lib/flash/utils/getTimer.as 
+!lib/flash/utils/setTimeout.as 
 test/**/bundle.js
 npm-debug.log
 *.map

scripts/AS3ExternsGenerator.hx

@@ -214,6 +214,13 @@ class AS3ExternsGenerator {
 			return true;
 		}
 		if (options != null) {
+			if (options.includedSymbols != null) {
+				for (includedSymbol in options.includedSymbols) {
+					if (qname == includedSymbol) {
+						return false;
+					}
+				}
+			}
 			if (options.includedPackages != null) {
 				final qnameLastDotIndex = qname.lastIndexOf(".");
 				final qnamePack = qnameLastDotIndex != -1 ? qname.substr(0, qnameLastDotIndex).split(".") : [];
@@ -965,10 +972,39 @@ class AS3ExternsGenerator {
 			return true;
 		}
 		var qname = baseTypeToQname(baseType, []);
-		if (qname.indexOf(".") == -1) {
+		if (qname.indexOf(".") == -1 && ALWAYS_ALLOWED_REFERENCE_TYPES.indexOf(baseType.name) != -1) {
 			return true;
 		}
-		if (isInPackage(currentPackage, baseType.pack, true)) {
+		var baseTypePack = baseType.pack;
+		var i = 0;
+		if (options != null && options.renameSymbols != null) {
+			var renameSymbols = options.renameSymbols;
+			while (i < renameSymbols.length) {
+				var originalName = renameSymbols[i];
+				i++;
+				var newName = renameSymbols[i];
+				i++;
+				if (baseTypePack.indexOf(originalName) != -1) {
+					baseTypePack[baseTypePack.indexOf(originalName)] = newName;
+					break;
+				}
+			}
+		}
+		if (options != null && options.renamePackages != null) {
+			i = 0;
+			var renamePackages = options.renamePackages;
+			while (i < renamePackages.length) {
+				var originalName = renamePackages[i];
+				i++;
+				var newName = renamePackages[i];
+				i++;
+				if (baseTypePack.indexOf(originalName) != -1) {
+					baseTypePack[baseTypePack.indexOf(originalName)] = newName;
+					break;
+				}
+			}
+		}
+		if (isInPackage(currentPackage, baseTypePack, true)) {
 			return true;
 		}
 		return false;
@@ -1273,6 +1309,14 @@ typedef AS3GeneratorOptions = {
 	**/
 	?includedPackages:Array<String>,
 
+	/**
+		Externs will be generated for symbols specified.
+
+		Types from other packages may still be referenced by fields or method
+		signatures. Use `allowedPackageReferences` to restrict those too.
+	**/
+	?includedSymbols:Array<String>,
+
 	/**
 		When `includedPackages` is not empty, `allowedPackageReferences` may
 		be used to allow types from other packages to be used for field types,

scripts/TSExternsGenerator.hx

@@ -198,6 +198,13 @@ class TSExternsGenerator {
 			return true;
 		}
 		if (options != null) {
+			if (options.includedSymbols != null) {
+				for (includedSymbol in options.includedSymbols) {
+					if (qname == includedSymbol) {
+						return false;
+					}
+				}
+			}
 			if (options.includedPackages != null) {
 				final qnameLastDotIndex = qname.lastIndexOf(".");
 				final qnamePack = qnameLastDotIndex != -1 ? qname.substr(0, qnameLastDotIndex).split(".") : [];
@@ -1576,6 +1583,14 @@ typedef TSGeneratorOptions = {
 	**/
 	?includedPackages:Array<String>,
 
+	/**
+		Externs will be generated for symbols specified.
+
+		Types from other packages may still be referenced by fields or method
+		signatures. Use `allowedPackageReferences` to restrict those too.
+	**/
+	?includedSymbols:Array<String>,
+
 	/**
 		When `includedPackages` is not empty, `allowedPackageReferences` may
 		be used to allow types from other packages to be used for field types,

scripts/build.hxml

@@ -35,5 +35,5 @@
 -D webgl1
 --macro AS3ExternsGenerator.generate({outputPath: "../lib", includedPackages: ["openfl"], allowedPackageReferences: [], renameSymbols: ["openfl.VectorData", "openfl.Vector", "openfl.utils.ByteArrayData", "openfl.utils.ByteArray", "lime.app.Future", "openfl.utils.Future"]})
 --macro TSExternsGenerator.generate({outputPath: "../lib", includedPackages: ["openfl"], allowedPackageReferences: [], renameSymbols: ["openfl.VectorData", "openfl.Vector", "openfl.utils.ByteArrayData", "openfl.utils.ByteArray", "lime.app.Future", "openfl.utils.Future"]})
---macro AS3ExternsGenerator.generate({outputPath: "../lib", includedPackages: ["flash"], allowedPackageReferences: [], renameSymbols: ["flash.VectorData", "flash.Vector", "flash.utils.ByteArrayData", "flash.utils.ByteArray", "lime.app.Future", "flash.utils.Future", "flash.errors.IllegalOperationError", "IllegalOperationError", "flash.errors.IOError", "IOError", "flash.errors.ArgumentError", "ArgumentError", "flash.errors.SecurityError", "SecurityError"], renamePackages: ["openfl", "flash"]})
+--macro AS3ExternsGenerator.generate({outputPath: "../lib", includedPackages: ["flash"], includedSymbols: ["ArgumentError", "SecurityError"], allowedPackageReferences: [], renameSymbols: ["flash.VectorData", "flash.Vector", "flash.utils.ByteArrayData", "flash.utils.ByteArray", "lime.app.Future", "flash.utils.Future", "flash.errors.ArgumentError", "ArgumentError", "flash.errors.SecurityError", "SecurityError"], renamePackages: ["openfl", "flash"]})
 --no-inline