mediawiki-extensions-VisualEditor/modules/ve-mw/ui/actions/ve.ui.MWLinkAction.js

/*!
 * VisualEditor UserInterface MWLinkAction class.
 *
 * @copyright 2011-2015 VisualEditor Team and others; see http://ve.mit-license.org
 */

/**
 * Link action.
 *
 * Opens either MWLinkAnnotationInspector or MWLinkNodeInspector depending on what is selected.
 *
 * @class
 * @extends ve.ui.LinkAction
 * @constructor
 * @param {ve.ui.Surface} surface Surface to act on
 */
ve.ui.MWLinkAction = function VeUiMWLinkAction( surface ) {
	// Parent constructor
	ve.ui.MWLinkAction.super.call( this, surface );
};

/* Inheritance */

OO.inheritClass( ve.ui.MWLinkAction, ve.ui.LinkAction );

/* Static Properties */

/**
 * List of allowed methods for the action.
 *
 * @static
 * @property
 */
ve.ui.MWLinkAction.static.methods = ve.ui.MWLinkAction.super.static.methods.concat( [ 'open', 'autolinkMagicLink' ] );

/* Methods */

/**
 * Match the trailing punctuation set used for autolinks in wikitext.
 * Closing parens are only stripped if open parens are missing from the
 * candidate text, so that URLs with embedded matched parentheses (like
 * wiki articles with disambiguation text) autolink nicely.
 *
 * @method
 * @inheritdoc
 */
ve.ui.MWLinkAction.prototype.getTrailingPunctuation = function ( candidate ) {
	// This is:
	// * the "trailing punctuation" character set from
	//   Parse.php::makeFreeExternalLink(): [,;.:!?] and sometimes [)]
	// * extended with characters banned by EXT_LINK_URL_CLASS: []<>"
	// * further extended with international close quotes: "'”’›»“‘‹«」』
	//   https://en.wikipedia.org/wiki/Quotation_mark
	return /\(/.test( candidate ) ?
		/[,;.:!?\[\]<>\"\'”’›»“‘‹«」』]+$/ :
		/[,;.:!?\[\]<>\"\'”’›»“‘‹«」』)]+$/;
};

/**
 * @method
 * @inheritdoc
 * @return {ve.dm.MWExternalLinkAnnotation} The annotation to use.
 */
ve.ui.MWLinkAction.prototype.getLinkAnnotation = function ( linktext ) {
	var title, targetData, m,
		href = linktext;
	// The link has been validated in #autolinkMagicLink and/or
	// #autolinkUrl, so we can use a quick and dirty regexp here to pull
	// apart the magic link.
	m = /^(RFC|PMID|ISBN)\s+(\S.*)$/.exec( linktext );
	if ( m && m[ 1 ] === 'RFC' ) {
		href = '//tools.ietf.org/html/rfc' + m[ 2 ];
	} else if ( m && m[ 1 ] === 'PMID' ) {
		href = '//www.ncbi.nlm.nih.gov/pubmed/' + m[ 2 ] + '?dopt=Abstract';
	} else if ( m && m[ 1 ] === 'ISBN' ) {
		title = mw.Title.newFromText( 'Special:BookSources/' + m[ 2 ].replace( /[^0-9Xx]/g, '' ) );
	} else {
		targetData = ve.dm.MWInternalLinkAnnotation.static.getTargetDataFromHref(
			href,
			this.surface.getModel().getDocument().getHtmlDocument()
		);
		if ( targetData.isInternal ) {
			title = mw.Title.newFromText( targetData.title );
		}
	}
	return title ?
		ve.dm.MWInternalLinkAnnotation.static.newFromTitle( title ) :
		new ve.dm.MWExternalLinkAnnotation( {
			type: 'link/mwExternal',
			attributes: { href: href }
		} );
};

/**
 * Autolink the selected RFC/PMID/ISBN, which may have trailing whitespace.
 *
 * @see ve.ui.LinkAction#autolinkUrl
 * @method
 * @return {boolean}
 *   True if the selection is a valid RFC/PMID/ISBN and the autolink action
 *   was executed; otherwise false.
 */
ve.ui.MWLinkAction.prototype.autolinkMagicLink = function () {
	return this.autolink( function ( linktext ) {
		if ( /^(RFC|PMID) [0-9]+$/.test( linktext ) ) {
			return true; // Valid RFC/PMID
		}
		if ( /^ISBN (97[89][- ]?)?([0-9][- ]?){9}[0-9Xx]$/.test( linktext ) ) {
			return true; // Valid ISBN
		}
		return false;
	} );
};

/**
 * Open either the 'link' or 'linkNode' window, depending on what is selected.
 *
 * @method
 * @return {boolean} Action was executed
 */
ve.ui.MWLinkAction.prototype.open = function () {
	var fragment = this.surface.getModel().getFragment(),
		windowName = 'link';

	if ( fragment.getSelectedNode() instanceof ve.dm.MWNumberedExternalLinkNode ) {
		windowName = 'linkNode';
	}
	this.surface.execute( 'window', 'open', windowName );
	return true;
};

/* Registration */

ve.ui.actionFactory.register( ve.ui.MWLinkAction );

ve.ui.commandRegistry.register(
	new ve.ui.Command(
		'autolinkMagicLink', ve.ui.MWLinkAction.static.name, 'autolinkMagicLink',
		{ supportedSelections: [ 'linear' ] }
	)
);

ve.ui.sequenceRegistry.register(
	// This regexp doesn't have to be precise; we'll validate the magic
	// link in #autolinkMagicLink above.
	new ve.ui.Sequence( 'autolinkMagicLink', 'autolinkMagicLink', /\b(RFC|PMID|ISBN)\s+[0-9]([- 0-9]*[0-9Xx])?(\s|\n\n)$/, 0, true )
);