json-photoshop-scripting/Utility-Scripts/Parse-JavaScript-Code/Parse JavaScript Code.js

/*

<javascriptresource>
<name>Parse JavaScript Code...</name>
<about>"Parse JavaScript Code" v1.3

Parse JavaScript code to an abstract syntax tree (AST) or to a list of tokens.

Utility script using the "JSON Action Manager" scripting library.
© 2014-2015 Michel MARIANI.
</about>
<menu>automate</menu>
<category>JSON Action Manager Syntax Utility</category>
</javascriptresource>

*/

//------------------------------------------------------------------------------
// File: Parse JavaScript Code.js
// Version: 1.3
// Release Date: 2015-11-27
// Copyright: © 2014-2015 Michel MARIANI <http://www.tonton-pixel.com/blog/>
// Licence: GPL <http://www.gnu.org/licenses/gpl.html>
//------------------------------------------------------------------------------
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// 
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
// 
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
//------------------------------------------------------------------------------
// Version History:
//  1.3:
//  - Used new version 4.4.4 of jamEngine scripting library module.
//  1.2:
//  - Used new version 4.4.1 of scripting library modules.
//  1.1:
//  - Renamed include file "esprima.js" to "esprima.jsxinc" to avoid being
//    displayed in Photoshop Scripts menu.
//  - Used new version 4.4 of scripting library modules.
//  1.0:
//  - Initial release.
//------------------------------------------------------------------------------

// jamEngine.jsxinc v4.4.4 (minified)
if(typeof jamEngine!=='object') {var jamEngine={};(function() {var that;jamEngine.meaningfulIds=false;jamEngine.parseFriendly=false;jamEngine.displayDialogs=DialogModes.ERROR;var conflictingStringIdStrs={"'Algn'":["align","alignment"],"'AntA'":["antiAlias","antiAliasedPICTAcquire"],"'BckL'":["backgroundLayer","backgroundLevel"],"'BlcG'":["blackGenerationType","blackGenerationCurve"],"'BlcL'":["blackLevel","blackLimit"],"'Blks'":["blacks","blocks"],"'BlrM'":["blurMethod","blurMore"],"'BrgC'":["brightnessEvent","brightnessContrast"],"'BrsD'":["brushDetail","brushesDefine"],"'Brsh'":["brush","brushes"],"'Clcl'":["calculation","calculations"],"'ClrP'":["colorPalette","coloredPencil"],"'Cnst'":["constant","constrain"],"'CntC'":["centerCropMarks","conteCrayon"],"'Cntr'":["center","contrast"],"'CrtD'":["createDroplet","createDuplicate"],"'CstP'":["customPalette","customPhosphors"],"'Cstm'":["custom","customPattern"],"'Drkn'":["darken","darkness"],"'Dstr'":["distort","distortion","distribute","distribution"],"'Dstt'":["desaturate","destWhiteMax"],"'FlIn'":["fileInfo","fillInverse"],"'Gd  '":["good","guide"],"'GnrP'":["generalPreferences","generalPrefs","preferencesClass"],"'GrSt'":["grainStippled","graySetup"],"'Grdn'":["gradientClassEvent","gridMinor"],"'Grn '":["grain","green"],"'Grns'":["graininess","greens"],"'HstP'":["historyPreferences","historyPrefs"],"'HstS'":["historyState","historyStateSourceType"],"'ImgP'":["imageCachePreferences","imagePoint"],"'In  '":["in","stampIn"],"'IntW'":["interfaceWhite","intersectWith"],"'Intr'":["interfaceIconFrameDimmed","interlace","interpolation","intersect"],"'JPEG'":["JPEG","JPEGFormat"],"'LghD'":["lightDirection","lightDirectional"],"'LghO'":["lightOmni","lightenOnly"],"'LghS'":["lightSource","lightSpot"],"'Lns '":["lens","lines"],"'Mgnt'":["magenta","magentas"],"'MrgL'":["mergeLayers","mergedLayers"],"'Mxm '":["maximum","maximumQuality"],"'NTSC'":["NTSC","NTSCColors"],"'NmbL'":["numberOfLayers","numberOfLevels"],"'PlgP'":["pluginPicker","pluginPrefs"],"'Pncl'":["pencilEraser","pencilWidth"],"'Pnt '":["paint","point"],"'Prsp'":["perspective","perspectiveIndex"],"'PrvM'":["previewMacThumbnail","previewMagenta"],"'Pstr'":["posterization","posterize"],"'RGBS'":["RGBSetup","RGBSetupSource"],"'Rds '":["radius","reds"],"'ScrD'":["scratchDisks","screenDot"],"'ShdI'":["shadingIntensity","shadowIntensity"],"'ShpC'":["shapeCurveType","shapingCurve"],"'ShrE'":["sharpenEdges","shearEd"],"'Shrp'":["sharpen","sharpness"],"'SplC'":["splitChannels","supplementalCategories"],"'Spot'":["spot","spotColor"],"'SprS'":["separationSetup","sprayedStrokes"],"'StrL'":["strokeLength","strokeLocation"],"'Strt'":["saturation","start"],"'TEXT'":["char","textType"],"'TIFF'":["TIFF","TIFFFormat"],"'TglO'":["toggleOptionsPalette","toggleOthers"],"'TrnG'":["transparencyGamutPreferences","transparencyGrid","transparencyGridSize"],"'TrnS'":["transferSpec","transparencyShape","transparencyStop"],"'Trns'":["transparency","transparent"],"'TxtC'":["textClickPoint","textureCoverage"],"'TxtF'":["textureFile","textureFill"],"'UsrM'":["userMaskEnabled","userMaskOptions"],"'c@#^'":["inherits","pInherits"],"'comp'":["comp","sInt64"],"'doub'":["floatType","IEEE64BitFloatingPoint","longFloat"],"'long'":["integer","longInteger","sInt32"],"'magn'":["magnitude","uInt32"],"'null'":["null","target"],"'shor'":["sInt16","sMInt","shortInteger"],"'sing'":["IEEE32BitFloatingPoint","sMFloat","shortFloat"]};jamEngine.getConflictingStringIdStrs=function(charIdStr) {return conflictingStringIdStrs[charIdStr]||null;};jamEngine.uniIdStrToId=function(uniIdStr) {var id=0;if(typeof uniIdStr==='string') {if((uniIdStr.length===(1+4+1))&&(uniIdStr.charAt(0)==="'")&&(uniIdStr.charAt(5)==="'")) {id=app.charIDToTypeID(uniIdStr.substring(1,5));} else {id=app.stringIDToTypeID(uniIdStr);}} return id;};var smallestHashValue=app.charIDToTypeID("    ");jamEngine.idToUniIdStrs=function(id) {var charIdStr="";var stringIdStr=app.typeIDToStringID(id);if(id>=smallestHashValue) {charIdStr="'"+app.typeIDToCharID(id)+"'";if(stringIdStr!=="") {if(charIdStr in conflicting
// jamJSON.jsxinc v4.4 (minified)
if(typeof jamJSON!=='object') {var jamJSON={};(function() {var state;var stack;var container;var key;var value;var escapes={'\\':'\\','"':'"','/':'/','t':'\t','n':'\n','r':'\r','f':'\f','b':'\b'};var action={'{':{go:function() {stack.push({state:'ok'});container={};state='firstokey';},ovalue:function() {stack.push({container:container,state:'ocomma',key:key});container={};state='firstokey';},firstavalue:function() {stack.push({container:container,state:'acomma'});container={};state='firstokey';},avalue:function() {stack.push({container:container,state:'acomma'});container={};state='firstokey';}},'}':{firstokey:function() {var pop=stack.pop();value=container;container=pop.container;key=pop.key;state=pop.state;},ocomma:function() {var pop=stack.pop();container[key]=value;value=container;container=pop.container;key=pop.key;state=pop.state;}},'[':{go:function() {stack.push({state:'ok'});container=[];state='firstavalue';},ovalue:function() {stack.push({container:container,state:'ocomma',key:key});container=[];state='firstavalue';},firstavalue:function() {stack.push({container:container,state:'acomma'});container=[];state='firstavalue';},avalue:function() {stack.push({container:container,state:'acomma'});container=[];state='firstavalue';}},']':{firstavalue:function() {var pop=stack.pop();value=container;container=pop.container;key=pop.key;state=pop.state;},acomma:function() {var pop=stack.pop();container.push(value);value=container;container=pop.container;key=pop.key;state=pop.state;}},':':{colon:function() {if(container.hasOwnProperty(key)) {throw new SyntaxError("[jamJSON.parse] Duplicate key: “"+key+"”");} state='ovalue';}},',':{ocomma:function() {container[key]=value;state='okey';},acomma:function() {container.push(value);state='avalue';}},'true':{go:function() {value=true;state='ok';},ovalue:function() {value=true;state='ocomma';},firstavalue:function() {value=true;state='acomma';},avalue:function() {value=true;state='acomma';}},'false':{go:function() {value=false;state='ok';},ovalue:function() {value=false;state='ocomma';},firstavalue:function() {value=false;state='acomma';},avalue:function() {value=false;state='acomma';}},'null':{go:function() {value=null;state='ok';},ovalue:function() {value=null;state='ocomma';},firstavalue:function() {value=null;state='acomma';},avalue:function() {value=null;state='acomma';}}};var number={go:function() {state='ok';},ovalue:function() {state='ocomma';},firstavalue:function() {state='acomma';},avalue:function() {state='acomma';}};var string={go:function() {state='ok';},firstokey:function() {key=value;state='colon';},okey:function() {key=value;state='colon';},ovalue:function() {state='ocomma';},firstavalue:function() {state='acomma';},avalue:function() {state='acomma';}};var commentFunc=function(){};function debackslashify(text) {return text.replace(/\\(?:u(.{4})|([^u]))/g,function(a,b,c){return(b)?String.fromCharCode(parseInt(b,16)):escapes[c];});} jamJSON.parse=function(text,validate,allowComments) {if(validate) {var tx=/^[\x20\t\n\r]*(?:([,:\[\]{}]|true|false|null)|(-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+\-]?[0-9]+)?)|"((?:[^\r\n\t\\\"]|\\(?:["\\\/trnfb]|u[0-9a-fA-F]{4}))*)")/;var txc=/^[\x20\t\n\r]*(?:(\/(?:\/.*|\*(?:.|[\r\n])*?\*\/))|([,:\[\]{}]|true|false|null)|(-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+\-]?[0-9]+)?)|"((?:[^\r\n\t\\\"]|\\(?:["\\\/trnfb]|u[0-9a-fA-F]{4}))*)")/;var r;var i;var actionFunc;state='go';stack=[];try {while(true) {i=(allowComments)?1:0;r=(allowComments)?txc.exec(text):tx.exec(text);if(!r) {break;} if(allowComments&&r[1]) {actionFunc=commentFunc;} else if(r[i+1]) {actionFunc=action[r[i+1]][state];} else if(r[i+2]) {value=+r[i+2];actionFunc=number[state];} else {value=debackslashify(r[i+3]);actionFunc=string[state];} if(actionFunc) {actionFunc();text=text.slice(r[0].length);} else {break;}}} catch(e) {state=e;} if(state!=='ok'||/[^\x20\t\n\r]/.test(text)) {throw state instanceof SyntaxError?state:new SyntaxError("[jamJSON.parse] Invalid JSON");} return value;} else {return eval('('+text+')');}};var escapable=/[\\\"\x00-\x1F\x7F-\x9F\u00AD\u0600-\u0604
// jamUtils.jsxinc v4.4 (minified)
if(typeof jamUtils!=='object') {var jamUtils={};(function() {jamUtils.toDistanceUnit=function(amount,amountBasePerInch) {return(amount/amountBasePerInch)*72.0;};jamUtils.fromDistanceUnit=function(amount,amountBasePerInch) {return(amount/72.0)*amountBasePerInch;};jamUtils.fontExists=function(fontPostScriptName) {var useDOM=true;var found=false;if(useDOM) {for(var i=0;i<app.fonts.length;i++) {if(app.fonts[i].postScriptName===fontPostScriptName) {found=true;break;}}} else {var saveMeaningfulIds=jamEngine.meaningfulIds;var saveParseFriendly=jamEngine.parseFriendly;jamEngine.meaningfulIds=true;jamEngine.parseFriendly=true;var resultDescriptorObj=jamEngine.jsonGet ([["property",["<property>","fontList"]],["application",["<enumerated>",["ordinal","targetEnum"]]]]);var fontPostScriptNameArr=resultDescriptorObj["fontList"][1][1]["fontPostScriptName"][1];for(var i=0;i<fontPostScriptNameArr.length;i++) {if(fontPostScriptNameArr[i][1]===fontPostScriptName) {found=true;break;}} jamEngine.meaningfulIds=saveMeaningfulIds;jamEngine.parseFriendly=saveParseFriendly;} return found;};jamUtils.loadAction=function(action,actionSet,actionsFilePath) {try {jamEngine.jsonGet([["action",["<name>",action]],["actionSet",["<name>",actionSet]]]);var found=true;} catch(e) {var found=false;} if(!found) {jamEngine.jsonPlay("open",{"target":["<path>",actionsFilePath]});}};jamUtils.loadActionSet=function(actionSet,actionsFilePath) {try {jamEngine.jsonGet([["actionSet",["<name>",actionSet]]]);var found=true;} catch(e) {var found=false;} if(!found) {jamEngine.jsonPlay("open",{"target":["<path>",actionsFilePath]});}};jamUtils.loadPreset=function(presetProperty,presetName,presetFilePath) {var useDOM=false;var useOpen=true;var classes={"brush":"brush","colors":"color","gradientClassEvent":"gradientClassEvent","style":"styleClass","pattern":"'PttR'","shapingCurve":"shapingCurve","customShape":"customShape","toolPreset":"toolPreset"};var presetClass=classes[presetProperty];var saveMeaningfulIds=jamEngine.meaningfulIds;var saveParseFriendly=jamEngine.parseFriendly;jamEngine.meaningfulIds=true;jamEngine.parseFriendly=true;var found=false;var resultDescriptorObj=jamEngine.jsonGet ([["property",["<property>","presetManager"]],["application",["<enumerated>",["ordinal","targetEnum"]]]]);var presetManagerArr=resultDescriptorObj["presetManager"][1];for(var i=0;i<presetManagerArr.length;i++) {var presets=presetManagerArr[i][1];if(presets[0]===presetClass) {var presetsArr=presets[1]["name"][1];for(var j=0;j<presetsArr.length;j++) {if(presetsArr[j][1]===presetName) {found=true;break;}} break;}} if(!found) {if(useDOM) {app.load(new File(presetFilePath));} else if(useOpen) {jamEngine.jsonPlay("open",{"target":["<path>",presetFilePath]});} else {jamEngine.jsonPlay ("set",{"target":["<reference>",[["property",["<property>",presetProperty]],["application",["<enumerated>",["ordinal","targetEnum"]]]]],"to":["<path>",presetFilePath],"append":["<boolean>",true]});}} jamEngine.meaningfulIds=saveMeaningfulIds;jamEngine.parseFriendly=saveParseFriendly;};function getFileObject(file) {var fileObject;if(file instanceof File) {fileObject=file;} else if(typeof file==='string') {fileObject=new File(file);} else {throw new Error('[jamUtils getFileObject] Invalid argument');} return fileObject;} jamUtils.readTextFile=function(textFile) {var text=null;var file=getFileObject(textFile);if(file.open("r")) {text=file.read();file.close();} return text;};jamUtils.readJsonFile=function(jsonFile) {return jamJSON.parse(this.readTextFile(jsonFile),true);};jamUtils.writeTextFile=function(textFile,text) {var file=getFileObject(textFile);if(file.open('w','TEXT')) {file.encoding='UTF-8';file.lineFeed='unix';file.write('\uFEFF');file.write(text);file.close();}};jamUtils.writeJsonFile=function(jsonFile,data,space) {this.writeTextFile(jsonFile,jamJSON.stringify(data,space));};jamUtils.cloneData=function(data) {var clone;if(data===null) {clone=data;} else if(data.constructor===Object) {clone={};for(var k in data) {if(data.hasOwnProperty(k)) {clone[k]=this.cloneData(data[k]);}}} else if(data.constructor===Array)

//------------------------------------------------------------------------------

//@include "esprima.jsxinc"

//------------------------------------------------------------------------------

var signature = "json-action-manager-parse-javascript-code-options";

var defaultCode =
	"// Life, Universe, and Everything\r" +
	"var answer = 6 * 7;";

var defaultOptions =
{
	resultDefaultFile: "~/Desktop/parsed-javascript-code.json",
	code: defaultCode,
	tokenize: false,
	dialog:
	{
		width: 640,
		height: 768,
		x: 0,
		y: 0
	}
};

var openWithEditor = false;
var openParentFolder = false;

//------------------------------------------------------------------------------

function parseJavaScriptCode (code, tokenize)
{
	var parsedCode;
	try
	{
		parsedCode = (tokenize) ? esprima.tokenize (code) : esprima.parse (code);
	}
	catch (e)
	{
		parsedCode = "Error: Line " + e.lineNumber + ": " + e.message;
	}
	return parsedCode;
}

//------------------------------------------------------------------------------

function displayDialog ()
{
	// Get an available UI font among a list of favorites
	function getAvailableUIFont (fontsArray)
	{
		// List all fonts available in Photoshop in JSON format
		var fontsObj = { };
		for (var i = 0; i < app.fonts.length; i++)
		{
			var family = app.fonts[i].family;
			if (!(family in fontsObj))
			{
				fontsObj[family] = { };
			}
			fontsObj[family][app.fonts[i].style] =
			{
				"name": app.fonts[i].name
			};
		}
		var availableFont;
		var fontFamily;
		var fontStyle;
		var fontSize;
		for (var i = 0; i < fontsArray.length; i++)
		{
			fontFamily = fontsArray[i][0];
			if (fontFamily in fontsObj)
			{
				fontStyle = fontsArray[i][1];
				if (fontStyle in fontsObj[fontFamily])
				{
					fontSize = fontsArray[i][2];
					availableFont = ScriptUI.newFont (fontFamily, fontStyle, fontSize)
					break;
				}
			}
		}
		return availableFont;
	}
	var monospacedFont =
	getAvailableUIFont
	(
		[
			[ "Monaco", "Regular", 12 ],
			[ "Lucida Sans Typewriter", "Regular", 14 ],
			[ "Courier", "Regular", 16 ],
			[ "Courier New", "Regular", 14 ]
		]
	);
	var resultDefaultFile = new File (customOptions.resultDefaultFile);
	var dialog = new Window ('dialog', "Parse JavaScript Code", undefined, { resizeable: true });
	dialog.orientation = "column";
	dialog.preferredSize.width = customOptions.dialog.width;
	dialog.preferredSize.height = customOptions.dialog.height;
	dialog.onResizing = function ()
	{
		this.layout.resize ();
	};
	dialog.onShow = function ()
	{
		var x = customOptions.dialog.x;
		var y = customOptions.dialog.y;
		if ((x !== 0) || (y !== 0))
		{
			this.location.x = x;
			this.location.y = y;
		}
		codeArea.text = customOptions.code;
		tokenizeCheck.value = customOptions.tokenize;
		expandTabsCheck.value = customOptions.expandTabs;
		codeArea.active = true;
		saveResultButton.enabled = false;
	};
	var codeGroup = dialog.add ('group');
	codeGroup.orientation = "column";
	codeGroup.alignment = [ "fill", "top" ];
	var codeArea = codeGroup.add ('edittext', undefined, "\r\r\r\r\r\r\r\r\r\r\r\r\r\r\r", { multiline: true });
	codeArea.alignment = [ "fill", "fill" ];
	if (monospacedFont)
	{
		codeArea.graphics.font = monospacedFont;
	}
	function pressed (k)
	{
		if ((k.keyName === "Tab") || (k.keyIdentifier === "Enter"))	// *Not* (k.keyName === "Enter") !!
		{
			k.preventDefault ();
			if (!k.target.properties.readonly)
			{
				k.target.textselection = (k.keyName === "Tab") ? '\t' : '\n';
			}
		}
	};
	dialog.addEventListener ("keydown", pressed);
	var codeOptionsGroup = codeGroup.add ('group');
	var tokenizeCheck = codeOptionsGroup.add ('checkbox', undefined, 'Tokenize');
	var expandTabsCheck = codeOptionsGroup.add ('checkbox', undefined, 'Expand Tabs');
	var parseButton = codeGroup.add ('button', undefined, 'Parse');
	parseButton.alignment = [ "center", "center" ];
	parseButton.onClick = function ()
	{
		var parsedCode = parseJavaScriptCode (codeArea.text, tokenizeCheck.value);
		parsedCodeArea.text =
			(typeof parsedCode === 'string') ? parsedCode : jamJSON.stringify (parsedCode, expandTabsCheck.value ? 4 : '\t');
		saveResultButton.enabled = !(typeof parsedCode === 'string');
	};
	var parsedCodeArea = dialog.add ('edittext', undefined, "", { multiline: true, readonly: true });
	parsedCodeArea.alignment = [ "fill", "fill" ];
	parsedCodeArea.minimumSize = [ -1, 120 ];
	if (monospacedFont)
	{
		parsedCodeArea.graphics.font = monospacedFont;
	}
	var file;
	var saveResultButton = dialog.add ('button', undefined, 'Save...');
	saveResultButton.alignment = [ "center", "bottom" ];
	saveResultButton.onClick = function ()
	{
		file = resultDefaultFile.saveDlg ("Save JSON text to file:");
		if (file)
		{
			jamUtils.writeTextFile (file, parsedCodeArea.text);
			if (openWithEditor)
			{
				file.execute ();
			}
			else if (openParentFolder)
			{
				file.parent.execute ();
			}
			resultDefaultFile = file;
		}
		codeArea.active = true;
	};
	var modalButtonsGroup = dialog.add ('group');
	modalButtonsGroup.alignment = [ "right", "bottom" ];
	modalButtonsGroup.orientation = "row";
	modalButtonsGroup.alignChildren = "fill";
	var cancelButton = modalButtonsGroup.add ('button', undefined, 'Cancel', { name: "cancel" });
	cancelButton.onClick = function ()
	{
		dialog.close (false);
	};
	var okButton = modalButtonsGroup.add ('button', undefined, 'OK', { name: "ok" });
	okButton.onClick = function ()
	{
		customOptions.resultDefaultFile = resultDefaultFile.fsName;
		customOptions.code = codeArea.text;
		customOptions.tokenize = tokenizeCheck.value;
		customOptions.expandTabs = expandTabsCheck.value;
		customOptions.dialog.width = dialog.size.width;
		customOptions.dialog.height = dialog.size.height;
		customOptions.dialog.x = dialog.location.x;
		customOptions.dialog.y = dialog.location.y;
		dialog.close (true);
	};
	return dialog.show ();
}

//------------------------------------------------------------------------------

var appVersion = parseInt (app.version);
// Requires: support for cut and paste, getCustomOptions (), putCustomOptions (), newFont (), addEventListener ("keydown"), preventDefault ()...
if (appVersion >= 11)	// CS4 or later
{
	var customOptions = jamUtils.getCustomOptions (signature, defaultOptions);
	if (displayDialog ())
	{
		jamUtils.putCustomOptions (signature, customOptions, true);
	}
}
else
{
	alert ("Sorry, this script requires Photoshop CS4 or later.");
}

//------------------------------------------------------------------------------