A Gaussian blur filter. With this filter, you can blur an area of a PIXI.DisplayObject. This cannot
+be done with the PIXI.filters.BlurFilter (when you use the PIXI.filters.BlurFilter with
+an filter area, all pixels outside of the area are not displayed). Attention: The area of
+the filter is always in global scope, NOT relative to the PIXI.DisplayObject the filter
+is assigned to!
The area where the blur effect should be applied to. Relative to the
+ canvas, NOT relative to the PIXI.DisplayObject where the blur effect is assigned to!
+
+
+
+
+
+
+
blur
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 50
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The strength of the blur.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Example
+
+
+
+
// Create the app
+const app = new PIXIApp({
+ view: canvas,
+ width: 480,
+ height: 270,
+ transparent: false
+}).setup().run()
+
+// Add a video sprite
+const sprite = new PIXI.Sprite(PIXI.Texture.fromVideo("assets/blurfilter.mp4"))
+sprite.width = app.size.width
+sprite.height = app.size.height
+app.scene.addChild(sprite)
+
+// Create the filter and assign it to the scene
+const blurFilter = new BlurFilter(new PIXI.Rectangle(20, 20, 80, 60))
+app.scene.filters = [blurFilter]
The type of the button. Can be default or checkbox. When the type is
+ checkbox, the active state is toggled automatically.
+
+
+
+
+
+
+
align
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ center
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The horizontal position of the label and the icon. Possible values are
+ left, center and right. Only affects the style when the minWidth is bigger than the width of the icon and label.
+
+
+
+
+
+
+
verticalAlign
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ middle
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The vertical position of the label and the icon. Possible values are
+ top, middle and button. Only affects the style when the minHeight is bigger than the height of the icon and label.
+
+
+
+
+
+
+
tooltip
+
+
+
+
+
+string
+|
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A string for the label of the tooltip or an object to configure the tooltip
+ to display.
+
+
+
+
+
+
+
badge
+
+
+
+
+
+string
+|
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A string for the label of the badge or an object to configure the badge to display.
+ If the parameter is an object, all badge options can be set plus the following:
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
align
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ right
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The horizontal alignment of the badge. Possible values: left, center, right
+
+
+
+
+
+
+
verticalAlign
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ top
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The vertical alignment of the badge. Possible values: top, middle, bottom
+
+
+
+
+
+
+
offsetLeft
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 0
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The horizontal shift of the badge.
+
+
+
+
+
+
+
offsetTop
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 0
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The vertical shift of the badge.
+
+
+
+
+
+
+
+
+
+
+
+
+
visible
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Is the button initially visible (property visible)?
// Create the button
+const button = new Button({
+ label: 'My Button',
+ action: () => console.log('Button was clicked')
+})
+
+// Add the button to a DisplayObject
+app.scene.addChild(button)
+
+
+
+
+
+
+
+
+
+
Extends
+
+
+
PIXI.Container
+
+
+
+
+
+
+
+
+
+
+
+
+
Members
+
+
+
+
+
+
+
+ active
+ boolean
+
+
+
+
+
+
+
+
+
+
+
+
+
Gets or sets the active state.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ disabled
+ boolean
+
+
+
+
+
+
+
+
+
+
+
+
+
Gets or sets the disabled state. When disabled, the button cannot be clicked.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ iconColor
+ number
+
+
+
+
+
+
+
+
+
+
+
+
+
Gets or sets the color of the current icon (no matter how the status is). Changing the color, changes
+the tint property of the icon sprite.
An options object to specify to style and behaviour of the button group.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
id
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ auto generated
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The id of the button group.
+
+
+
+
+
+
+
x
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 0
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The x position of the button group. Can be also set after creation with buttonGroup.x = 0.
+
+
+
+
+
+
+
y
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 0
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The y position of the button group. Can be also set after creation with buttonGroup.y = 0.
+
+
+
+
+
+
+
buttons
+
+
+
+
+
+Array.<object>
+
+
+
+
+
+
+
+
+ []
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An array of the buttons of the button group. One item of the array (one object)
+ can have exactly the same properties as an Button object when instantiating a Button. If a property of the button group
+ conflicts with a property of a button object, the value from the button object will be used.
The theme to use for this button group. Possible values are dark, light, red
+ or a Theme object.
+
+
+
+
+
+
+
minWidth
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 44
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The minimum width of one button.
+
+
+
+
+
+
+
minHeight
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 44
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The minimum height of one button.
+
+
+
+
+
+
+
padding
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.padding
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The inner spacing (distance from icon and/or label) the the border.
+
+
+
+
+
+
+
margin
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.margin
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The outer spacing (distance from one button to the previous/next button).
+
+
+
+
+
+
+
iconPosition
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ left
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The position of the icon in relation to the label. Can be left or right.
+
+
+
+
+
+
+
iconColor
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.iconColor
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The color of the icon (set by the tint property) as a hex value.
+
+
+
+
+
+
+
iconColorActive
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.iconColorActive
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The color of the icon when activated.
+
+
+
+
+
+
+
fill
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.fill
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The color of the button background as a hex value.
+
+
+
+
+
+
+
fillAlpha
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.fillAlpha
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The alpha value of the background.
+
+
+
+
+
+
+
fillActive
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.fillActive
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The color of the button background when activated.
+
+
+
+
+
+
+
fillActiveAlpha
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.fillActiveAlpha
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The alpha value of the background when activated.
+
+
+
+
+
+
+
stroke
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.stroke
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The color of the border as a hex value.
+
+
+
+
+
+
+
strokeWidth
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.strokeWidth
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The width of the border in pixel.
+
+
+
+
+
+
+
strokeAlpha
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.strokeAlpha
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The alpha value of the border.
+
+
+
+
+
+
+
strokeActive
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.strokeActive
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The color of the border when activated.
+
+
+
+
+
+
+
strokeActiveWidth
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.strokeActiveWidth
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The width of the border in pixel when activated.
+
+
+
+
+
+
+
strokeActiveAlpha
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.strokeActiveAlpha
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The alpha value of the border when activated.
+
+
+
+
+
+
+
textStyle
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+ Theme.textStyle
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: A textstyle object for the styling of the label. See PIXI.TextStyle
+ for possible options.
+
+
+
+
+
+
+
textStyleActive
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.textStyleActive
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: A textstyle object for the styling of the label when the
+ button is activated. See PIXI.TextStyle for possible options.
+
+
+
+
+
+
+
style
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ default
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A shortcut for styling options. Possible values are default, link.
+
+
+
+
+
+
+
radius
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ Theme.radius
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The radius of the four corners of the button (which is a rounded rectangle).
+
+
+
+
+
+
+
disabled
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ false
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Is the button group disabled? When disabled, the button group has a lower alpha value
+ and cannot be clicked (interactive of every button is set to false).
+
+
+
+
+
+
+
type
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ default
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The type of the button group. Can be default, checkbox or radio. When the type is
+ checkbox, the active state is toggled for each button automatically. When the type is radio, only one button can
+ be activated at the same time.
+
+
+
+
+
+
+
orientation
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ horizontal
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The orientation of the button group. Can be horizontal or vertical.
+
+
+
+
+
+
+
align
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ center
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The horizontal position of the label and the icon. Possible values are
+ left, center and right. Only affects the style when the minWidth is bigger than the width of the icon and label.
+
+
+
+
+
+
+
verticalAlign
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ middle
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Button: The vertical position of the label and the icon. Possible values are
+ top, middle and bottom. Only affects the style when the minHeight is bigger than the height of the icon and label.
+
+
+
+
+
+
+
visible
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Is the button group initially visible (property visible)?
The main class of a deeply zoomable image that is represented by a hierarchy
+of tile layers for each zoom level. This gives the user the impression that
+even huge pictures (up to gigapixel-images) can be zoomed instantaneously,
+since the tiles at smaller levels are scaled immediately and overloaded by
+more detailed tiles at the larger level as fast as possible.
Overrides PIXI.Container.calculateBounds()
+Skips the children and only considers the deep zoom base size. Calls
+the also overwritten _calculateBounds method.
Loads all tiles that are needed to fill the browser window.
+If the optional about parameter is provided (as a point with col as x,
+and row as y attr) the tiles are sorted by the distance to this point.
Reads the DeepZoomInfo object and initializes all tile layers.
+Called by the constructor.
+Creates the sprite for the loaded texture and add the sprite to the tile
+layer.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
+
Description
+
+
+
+
+
+
+
+
+
deepZoomInfo
+
+
+
+
+
+Object
+
+
+
+
+
+
+
+
+
+
the DeepZoomInfo instance
+
+
+
+
+
+
+
center
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+
+
If true ensures that the pivot is set to the center
A callback function that can be used by a Scatter view to inform
+the zoomable image that it has been moved, rotated or scaled, and should
+load tiles accordingly.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
+
Description
+
+
+
+
+
+
+
+
+
translated
+
+
+
+
+
+PIXI.Point
+
+
+
+
+
+
+
+
+
+
the movement of the scatter
+
+
+
+
+
+
+
scale
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+
+
the zoom factor
+
+
+
+
+
+
+
about
+
+
+
+
+
+PIXI.Point
+
+
+
+
+
+
+
+
+
+
the anchor point of the zoom
+
+
+
+
+
+
+
fast
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+
+
informs the callback to return as fast as possible,
+ i.e. after loading a single tile
+
+
+
+
+
+
+
debug
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+
+
log debug infos
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/doc/out/DeepZoomInfo.html b/doc/out/DeepZoomInfo.html
new file mode 100644
index 0000000..a7ba186
--- /dev/null
+++ b/doc/out/DeepZoomInfo.html
@@ -0,0 +1,2353 @@
+
+
+
+
+ iwmlib API Documentation
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Main additional method. Ensures that a text object is created that is cached
+under the given key.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
key
+
+
+
+
+
+*
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The cache key
+
+
+
+
+
+
+
label
+
+
+
+
+
+*
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The label to show
+
+
+
+
+
+
+
attrs
+
+
+
+
+
+*
+
+
+
+
+
+
+
+
+ {}
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Defines attributes of the text object.
+ align: 'right', 'left', or 'center'
+ justify: 'top', 'bottom', or 'center'
+ maxLines: {integer} truncates the text and adds ellipsis
+ maxHeight: {number} truncates text that needs more space and adds ellipsis
+ maxWidth: {number} word wraps text using hyphenation if possible
// Create the button and the modal when clicked
+const button = new Button({
+ label: 'Show Modal',
+ action: e => {
+ const modal = new Modal({
+ app: app,
+ header: 'This is the header',
+ content: 'This is the text.'
+ })
+ app.scene.addChild(modal)
+ }
+})
+
+// Add the button to a DisplayObject
+app.scene.addChild(button)
Loads sprites, e.g. images into the PIXI TextureCache.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
resources
+
+
+
+
+
+string
+|
+
+Array.<string>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
A String or an Array of urls to the images to load.
+
+
+
+
+
+
+
loaded
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+ null
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A callback which is executed after all resources has been loaded.
+ Receives one paramter, a Map of sprites where the key is the path of the image which was
+ loaded and the value is the PIXI.Sprite object.
+
+
+
+
+
+
+
opts
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An options object for more specific parameters.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
resolutionDependent
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Should the sprites be loaded dependent of the
+ renderer resolution?
Loads textures, e.g. images into the PIXI TextureCache.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
resources
+
+
+
+
+
+string
+|
+
+Array.<string>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
A String or an Array of urls to the images to load.
+
+
+
+
+
+
+
loaded
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+ null
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A callback which is executed after all resources has been loaded.
+ Receives one paramter, a Map of textures where the key is the path of the image which was
+ loaded and the value is the PIXI.Texture object.
+
+
+
+
+
+
+
opts
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An options object for more specific parameters.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
resolutionDependent
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Should the textures be loaded dependent of the
+ renderer resolution?
// Create the popup
+const popup = new Popup({
+ header: 'Goethe',
+ content: 'Man kann die Erfahrung nicht früh genug machen, wie entbehrlich man in der Welt ist.'
+})
+
+// Add the popup to a DisplayObject
+app.scene.addChild(popup)
An options object to specify to style and behaviour of the modal.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
items
+
+
+
+
+
+Array.<object>
+
+
+
+
+
+
+
+
+ []
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A list of the menu items. Each item must be of type object.
+ If an object has a label property, a PIXI.Text object is created (using the textStyle property).
+ If an object hasn't a label property, it must contain a content property which has to be a
+ PIXI.DisplayObject.
// Create the app with a new dark theme
+const app = new PIXIApp({
+ view: canvas,
+ width: 450,
+ height: 150,
+ theme: new ThemeDark()
+}).setup().run()
// Create the app with a new light theme
+const app = new PIXIApp({
+ view: canvas,
+ width: 450,
+ height: 150,
+ theme: new ThemeLight()
+}).setup().run()
// Create the app with a new red theme
+const app = new PIXIApp({
+ view: canvas,
+ width: 450,
+ height: 150,
+ theme: new ThemeRed()
+}).setup().run()
A utility class that describes a quad tree of tiles. Each tile on a given
+level has up to four corresponding tiles on the next level. A TileQuadNode
+uses the attributes nw (i.e. northwest), ne, sw, se to link to the
+quad nodes on the next level. The previous attributes links to the quad
+one level below that holds the given quad as nw, ne, sw, or se.
+We use this node class because we need a representation of tiles that are
+needed but not loaded yet to compute tiles which can be abandoned to reduce
+the memory pressure.
In the background, the class UITest uses the Greensock TimelineMax class. The opts object is passed directly to the TimelineMax class, so it can use any key that uses the TimelineMax class.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
+
Description
+
+
+
+
+
+
+
+
+
opts
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An options object to specify the behaviour of the test case.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
timeScale
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 1
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The speed at which the test should run, see https://greensock.com/docs/TimelineMax/timeScale().
+
+
+
+
+
+
+
eventType
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+ auto
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The type of events which should be used. Possible values: pointer, touch, mouse, auto. If set to auto, the eventType is set depending on the support of the browser used.
+
+
+
+
+
+
+
debug
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ false
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
If set to true, multiple informations will be print to the console.
+
+
+
+
+
+
+
defaultInterval
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The interval used when no action is specified for an action.
// Create the UITest object
+const test = new UITest({
+ timeScale: 2
+})
+
+// Add an action to the test case
+test.tap(button, {eventType: 'click'})
+
+// Start the test case
+test.start()
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Members
+
+
+
+
+
+
+
+ timeline
+ TimelineMax
+
+
+
+
+
+
+
+
+
+
+
+
+
Gets the Greensock TimelineMax object, used in the background of UITest.
Executes a pan event (pointerdown, pointermove, pointerup) on a specific element.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
element
+
+
+
+
+
+HTMLElement
+|
+
+string
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
The local position of the event in the context of the specified HTML element. If no position is specified, the center of the HTML element is used. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+
+
+
+
+
+
+
timelinePosition
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ One second after the last action.
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The position in seconds when the event should be triggered, see shttps://greensock.com/docs/TimelineMax/addCallback().
+
+
+
+
+
+
+
opts
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An options object to specify the behaviour of the action.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
onStart
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after the first event is fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
onUpdate
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after each execution of the second event. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
onComplete
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after the third event is fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
The target of the pan process. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+
+
+
+
+
+
+
duration
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 1
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The duration of the pan animation in seconds, see https://greensock.com/docs/TweenLite/duration().
+
+
+
+
+
+
+
ease
+
+
+
+
+
+Ease
+
+
+
+
+
+
+
+
+ Power0.easeNone
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The easing of the pan animation, see https://greensock.com/docs/Easing.
The event types to use. If no types are specified, the event types specified in the UITest constructor are used (or auto if not specified).
+
+
+
+
+
+
+
context
+
+
+
+
+
+Window
+|
+
+Frame
+
+
+
+
+
+
+
+
+ window
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The context within which the optionally specified element selector should be executed.
+
+
+
+
+
+
+
bubbles
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The Event property bubbles indicates whether the event bubbles up through the DOM or not.
+
+
+
+
+
+
+
cancelable
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Events' cancelable property indicates if the event can be canceled, and therefore prevented as if the event never happened. If the event is not cancelable, then its cancelable property will be false and the event listener cannot stop the event from occurring.
Executes a pinch event (pointerdown, pointermove, pointerup) on a specific element with two "fingers" simultaneously.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
element
+
+
+
+
+
+HTMLElement
+|
+
+string
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
The local position of the event in the context of the specified HTML element. If no position is specified, the center of the HTML element is used. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+
+
+
+
+
+
+
timelinePosition
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ One second after the last action.
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The position in seconds when the event should be triggered, see shttps://greensock.com/docs/TimelineMax/addCallback().
+
+
+
+
+
+
+
opts
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An options object to specify the behaviour of the action.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
onStart
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after the first events are fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
onUpdate
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after each execution of the second events. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
onComplete
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after the third events are fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
doubleCallbacks
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ false
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The callbacks onStart, onUpdate and onComplete will be fired only for one finger. If set to true, the events will be fired for both fingers.
+
+
+
+
+
+
+
distance
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 100
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The distance in pixels, how far the two "fingers" should move apart. If to or bezier specified, distance is ignored.
The targets of the pinch process. The position must be an array with two entries. An entry can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object. If bezier is specified, to is ignored.
The targets of the pinch process. The position must be an array with two entries. An entry may be an array of positions or a bezier object (https://greensock.com/docs/Plugins/BezierPlugin). A position in the array or the values array of the bezier object can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object. If bezier is specified, to is ignored.
+
+
+
+
+
+
+
duration
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ 1
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The duration of the pan animation in seconds, see https://greensock.com/docs/TweenLite/duration().
+
+
+
+
+
+
+
ease
+
+
+
+
+
+Ease
+
+
+
+
+
+
+
+
+ Power0.easeNone
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The easing of the pan animation, see https://greensock.com/docs/Easing.
The event types to use. If no types are specified, the event types specified in the UITest constructor are used (or auto if not specified).
+
+
+
+
+
+
+
context
+
+
+
+
+
+Window
+|
+
+Frame
+
+
+
+
+
+
+
+
+ window
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The context within which the optionally specified element selector should be executed.
+
+
+
+
+
+
+
bubbles
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The Event property bubbles indicates whether the event bubbles up through the DOM or not.
+
+
+
+
+
+
+
cancelable
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Events' cancelable property indicates if the event can be canceled, and therefore prevented as if the event never happened. If the event is not cancelable, then its cancelable property will be false and the event listener cannot stop the event from occurring.
Executes a tap event (pointerdown, pointerup) on a specific element.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
element
+
+
+
+
+
+HTMLElement
+|
+
+string
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
The local position of the event in the context of the specified HTML element. If no position is specified, the center of the HTML element is used. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+
+
+
+
+
+
+
timelinePosition
+
+
+
+
+
+number
+
+
+
+
+
+
+
+
+ One second after the last action.
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The position in seconds when the event should be triggered, see shttps://greensock.com/docs/TimelineMax/addCallback().
+
+
+
+
+
+
+
opts
+
+
+
+
+
+object
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
An options object to specify the behaviour of the action.
+
+
+
+
+
+
+
Name
+
+
+
Type
+
+
+
Default
+
+
+
Description
+
+
+
+
+
+
+
+
+
onStart
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after the first event is fired. Will not be fired if only one event is running (for example, a click event). Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
onComplete
+
+
+
+
+
+function
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
A function that runs after the second event is fired. Always fired, even if only one event is running (for example, a click event). Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+
+
+
+
+
+
+
eventTypes
+
+
+
+
+
+Array.<string>
+
+
+
+
+
+
+
+
+ ['pointerdown', 'pointerup']
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The event types to use. If no types are specified, the event types specified in the UITest constructor are used (or auto if not specified).
+
+
+
+
+
+
+
eventType
+
+
+
+
+
+string
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
If you want the tap method to fire only one event (for example, a click event), you can specify the opts.eventType parameter. If eventType is not null, the parameter opts.eventTypes is ignored.
+
+
+
+
+
+
+
context
+
+
+
+
+
+Window
+|
+
+Frame
+
+
+
+
+
+
+
+
+ window
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The context within which the optionally specified element selector should be executed.
+
+
+
+
+
+
+
bubbles
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
The Event property bubbles indicates whether the event bubbles up through the DOM or not.
+
+
+
+
+
+
+
cancelable
+
+
+
+
+
+boolean
+
+
+
+
+
+
+
+
+ true
+
+
+
+
+
+
+
+ optional
+
+
+
+
+
+
Events' cancelable property indicates if the event can be canceled, and therefore prevented as if the event never happened. If the event is not cancelable, then its cancelable property will be false and the event listener cannot stop the event from occurring.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/doc/out/Volatile.html b/doc/out/Volatile.html
new file mode 100644
index 0000000..469edf0
--- /dev/null
+++ b/doc/out/Volatile.html
@@ -0,0 +1,1850 @@
+
+
+
+
+ iwmlib API Documentation
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
import Theme from './theme.js'
+import Button from './button.js'
+
+/**
+ * Class that represents a PixiJS ButtonGroup.
+ *
+ * @example
+ * // Create the button group
+ * const buttonGroup = new ButtonGroup({
+ * buttons: [
+ * {label: 'Button 1', action: event => console.log(event)},
+ * {label: 'Button 2', action: event => console.log(event)},
+ * {label: 'Button 3', action: event => console.log(event)}
+ * ],
+ * minWidth: 100
+ * })
+ *
+ * // Add the button group to a DisplayObject
+ * app.scene.addChild(buttonGroup)
+ *
+ * @class
+ * @extends PIXI.Graphics
+ * @see {@link http://pixijs.download/dev/docs/PIXI.Graphics.html|PIXI.Graphics}
+ * @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/buttongroup.html|DocTest}
+ */
+export default class ButtonGroup extends PIXI.Graphics {
+
+ /**
+ * Creates an instance of a ButtonGroup.
+ *
+ * @constructor
+ * @param {object} [opts] - An options object to specify to style and behaviour of the button group.
+ * @param {number} [opts.id=auto generated] - The id of the button group.
+ * @param {number} [opts.x=0] - The x position of the button group. Can be also set after creation with buttonGroup.x = 0.
+ * @param {number} [opts.y=0] - The y position of the button group. Can be also set after creation with buttonGroup.y = 0.
+ * @param {object[]} [opts.buttons=[]] - An array of the buttons of the button group. One item of the array (one object)
+ * can have exactly the same properties as an Button object when instantiating a Button. If a property of the button group
+ * conflicts with a property of a button object, the value from the button object will be used.
+ * @param {string|Theme=} [opts.theme=dark] - The theme to use for this button group. Possible values are dark, light, red
+ * or a Theme object.
+ * @param {number} [opts.minWidth=44] - Button: The minimum width of one button.
+ * @param {number} [opts.minHeight=44] - Button: The minimum height of one button.
+ * @param {number} [opts.padding=Theme.padding] - Button: The inner spacing (distance from icon and/or label) the the border.
+ * @param {number} [opts.margin=Theme.margin] - The outer spacing (distance from one button to the previous/next button).
+ * @param {string} [opts.iconPosition=left] - Button: The position of the icon in relation to the label. Can be left or right.
+ * @param {number} [opts.iconColor=Theme.iconColor] - Button: The color of the icon (set by the tint property) as a hex value.
+ * @param {number} [opts.iconColorActive=Theme.iconColorActive] - Button: The color of the icon when activated.
+ * @param {number} [opts.fill=Theme.fill] - Button: The color of the button background as a hex value.
+ * @param {number} [opts.fillAlpha=Theme.fillAlpha] - Button: The alpha value of the background.
+ * @param {number} [opts.fillActive=Theme.fillActive] - Button: The color of the button background when activated.
+ * @param {number} [opts.fillActiveAlpha=Theme.fillActiveAlpha] - Button: The alpha value of the background when activated.
+ * @param {number} [opts.stroke=Theme.stroke] - Button: The color of the border as a hex value.
+ * @param {number} [opts.strokeWidth=Theme.strokeWidth] - Button: The width of the border in pixel.
+ * @param {number} [opts.strokeAlpha=Theme.strokeAlpha] - Button: The alpha value of the border.
+ * @param {number} [opts.strokeActive=Theme.strokeActive] - Button: The color of the border when activated.
+ * @param {number} [opts.strokeActiveWidth=Theme.strokeActiveWidth] - Button: The width of the border in pixel when activated.
+ * @param {number} [opts.strokeActiveAlpha=Theme.strokeActiveAlpha] - Button: The alpha value of the border when activated.
+ * @param {object} [opts.textStyle=Theme.textStyle] - Button: A textstyle object for the styling of the label. See PIXI.TextStyle
+ * for possible options.
+ * @param {number} [opts.textStyleActive=Theme.textStyleActive] - Button: A textstyle object for the styling of the label when the
+ * button is activated. See PIXI.TextStyle for possible options.
+ * @param {string} [opts.style=default] - A shortcut for styling options. Possible values are default, link.
+ * @param {number} [opts.radius=Theme.radius] - Button: The radius of the four corners of the button (which is a rounded rectangle).
+ * @param {boolean} [opts.disabled=false] - Is the button group disabled? When disabled, the button group has a lower alpha value
+ * and cannot be clicked (interactive of every button is set to false).
+ * @param {string} [opts.type=default] - The type of the button group. Can be default, checkbox or radio. When the type is
+ * checkbox, the active state is toggled for each button automatically. When the type is radio, only one button can
+ * be activated at the same time.
+ * @param {string} [opts.orientation=horizontal] - The orientation of the button group. Can be horizontal or vertical.
+ * @param {string} [opts.align=center] - Button: The horizontal position of the label and the icon. Possible values are
+ * left, center and right. Only affects the style when the minWidth is bigger than the width of the icon and label.
+ * @param {string} [opts.verticalAlign=middle] - Button: The vertical position of the label and the icon. Possible values are
+ * top, middle and bottom. Only affects the style when the minHeight is bigger than the height of the icon and label.
+ * @param {boolean} [opts.visible=true] - Is the button group initially visible (property visible)?
+ */
+ constructor(opts = {}) {
+
+ super()
+
+ const theme = Theme.fromString(opts.theme)
+ this.theme = theme
+
+ this.opts = Object.assign({}, {
+ id: PIXI.utils.uid(),
+ x: 0,
+ y: 0,
+ buttons: [],
+ minWidth: 44,
+ minHeight: 44,
+ padding: theme.padding,
+ margin: theme.margin,
+ iconPosition: 'left', // left, right
+ iconColor: theme.iconColor,
+ iconColorActive: theme.iconColorActive,
+ fill: theme.fill,
+ fillAlpha: theme.fillAlpha,
+ fillActive: theme.fillActive,
+ fillActiveAlpha: theme.fillActiveAlpha,
+ stroke: theme.stroke,
+ strokeWidth: theme.strokeWidth,
+ strokeAlpha: theme.strokeAlpha,
+ strokeActive: theme.strokeActive,
+ strokeActiveWidth: theme.strokeActiveWidth,
+ strokeActiveAlpha: theme.strokeActiveAlpha,
+ textStyle: theme.textStyle,
+ textStyleActive: theme.textStyleActive,
+ style: 'default',
+ radius: theme.radius,
+ disabled: null,
+ type: 'default', // default, checkbox, radio
+ orientation: 'horizontal',
+ align: 'center', // left, center, right
+ verticalAlign: 'middle', // top, middle, bottom
+ visible: true
+ }, opts)
+
+ this.buttons = []
+
+ this._disabled = null
+
+ this.visible = this.opts.visible
+
+ // setup
+ //-----------------
+ this.setup()
+
+ // layout
+ //-----------------
+ this.layout()
+ }
+
+ /**
+ * Creates children and instantiates everything.
+ *
+ * @private
+ * @return {ButtonGroup} A reference to the button group for chaining.
+ */
+ setup() {
+
+ // Buttons
+ //-----------------
+ let position = 0
+
+ for (let it of this.opts.buttons) {
+
+ delete it.x
+ delete it.y
+
+ if (this.opts.orientation === 'horizontal') {
+ it.x = position
+ } else {
+ it.y = position
+ }
+
+ it.theme = it.theme || this.opts.theme
+ it.minWidth = it.minWidth || this.opts.minWidth
+ it.minHeight = it.minHeight || this.opts.minHeight
+ it.padding = it.padding || this.opts.padding
+ it.iconPosition = it.iconPosition || this.opts.iconPosition
+ it.iconColor = it.iconColor || this.opts.iconColor
+ it.iconColorActive = it.iconColorActive || this.opts.iconColorActive
+ it.fill = it.fill || this.opts.fill
+ it.fillAlpha = it.fillAlpha || this.opts.fillAlpha
+ it.fillActive = it.fillActive || this.opts.fillActive
+ it.fillActiveAlpha = it.fillActiveAlpha || this.opts.fillActiveAlpha
+ it.stroke = it.stroke || this.opts.stroke
+ it.strokeWidth = it.strokeWidth != null ? it.strokeWidth : this.opts.strokeWidth
+ it.strokeAlpha = it.strokeAlpha != null ? it.strokeAlpha : this.opts.strokeAlpha
+ it.strokeActive = it.strokeActive || this.opts.strokeActive
+ it.strokeActiveWidth = it.strokeActiveWidth != null ? it.strokeActiveWidth : this.opts.strokeActiveWidth
+ it.strokeActiveAlpha = it.strokeActiveAlpha != null ? it.strokeActiveAlpha : this.opts.strokeActiveAlpha
+ it.textStyle = it.textStyle || this.opts.textStyle
+ it.textStyleActive = it.textStyleActive || this.opts.textStyleActive
+ it.style = it.style || this.opts.style
+ it.radius = it.radius != null ? it.radius : this.opts.radius
+ if (!it.type) {
+ switch (this.opts.type) {
+ case 'checkbox':
+ it.type = this.opts.type
+ break
+ default:
+ it.type = 'default'
+ break
+ }
+ }
+ //it.type = it.type || this.opts.type || 'default'
+ it.align = it.align || this.opts.align
+ it.verticalAlign = it.verticalAlign || this.opts.verticalAlign
+ it.afterAction = (event, button) => {
+ if (this.opts.type === 'radio' && button.opts.type === 'default') {
+ this.buttons.forEach(it => {
+ if (it.opts.type === 'default') {
+ it.active = false
+ }
+ })
+
+ if (button.opts.type === 'default') {
+ button.active = true
+ }
+ }
+ }
+
+ if (it.tooltip) {
+ if (typeof it.tooltip === 'string') {
+ it.tooltip = {content: it.tooltip, container: this}
+ } else {
+ it.tooltip = Object.assign({}, {container: this}, it.tooltip)
+ }
+ }
+
+ let button = new Button(it)
+
+ this.addChild(button)
+ this.buttons.push(button)
+
+ position += (this.opts.orientation === 'horizontal' ? button.width : button.height) + this.opts.margin
+ }
+
+ if (this.opts.orientation === 'vertical') {
+ const maxWidth = this.getMaxButtonWidth()
+
+ this.buttons.forEach(it => {
+ it.opts.minWidth = maxWidth
+ it.layout()
+ })
+ }
+
+ // disabled
+ //-----------------
+ if (this.opts.disabled != null) {
+ this.disabled = this.opts.disabled
+ }
+
+ return this
+ }
+
+ /**
+ * Should be called to refresh the layout of the button group. Can be used after resizing.
+ *
+ * @return {ButtonGroup} A reference to the button group for chaining.
+ */
+ layout() {
+
+ // set position
+ //-----------------
+ this.position.set(this.opts.x, this.opts.y)
+
+ // draw
+ //-----------------
+ this.draw()
+
+ return this
+ }
+
+ /**
+ * Draws the canvas.
+ *
+ * @private
+ * @return {ButtonGroup} A reference to the button group for chaining.
+ */
+ draw() {
+
+ if (this.opts.margin === 0) {
+
+ this.buttons.forEach(it => it.hide())
+
+ this.clear()
+ this.lineStyle(this.opts.strokeWidth, this.opts.stroke, this.opts.strokeAlpha)
+ this.beginFill(this.opts.fill, this.opts.fillAlpha)
+ this.drawRoundedRect(0, 0, this.width, this.height, this.opts.radius)
+
+ // Draw borders
+ this.lineStyle(this.opts.strokeWidth, this.opts.stroke, this.opts.strokeAlpha / 2)
+
+ this.buttons.forEach((it, i) => {
+ if (i > 0) {
+ this.moveTo(it.x, it.y)
+
+ if (this.opts.orientation === 'horizontal') {
+ this.lineTo(it.x, it.height)
+ } else {
+ this.lineTo(it.width, it.y)
+ }
+
+ }
+ })
+
+ this.endFill()
+ }
+
+ return this
+ }
+
+ /**
+ * Gets or sets the disabled state. When disabled, no button of the button group can be clicked.
+ *
+ * @member {boolean}
+ */
+ get disabled() {
+ return this._disabled
+ }
+
+ set disabled(value) {
+
+ this._disabled = value
+
+ this.buttons.forEach(it => it.disabled = value)
+ }
+
+ /**
+ * Searches all buttons of the button group and returns the maximum width of one button.
+ *
+ * @private
+ * @return {number} The maximum with of a button of the button group.
+ */
+ getMaxButtonWidth() {
+
+ let widths = this.buttons.map(it => it.width)
+
+ return Math.max(...widths)
+ }
+
+ /**
+ * Shows the button group (sets his alpha value to 1).
+ *
+ * @return {ButtonGroup} A reference to the button group for chaining.
+ */
+ show() {
+
+ this.alpha = 1
+
+ return this
+ }
+
+ /**
+ * Hides the button group (sets his alpha value to 0).
+ *
+ * @return {ButtonGroup} A reference to the button group for chaining.
+ */
+ hide() {
+
+ this.alpha = 0
+
+ return this
+ }
+}
+
/**
+ * Class that represents a PixiJS Theme.
+ *
+ * @example
+ * // Create the theme
+ * const yellow = new Theme({
+ * fill: 0xfecd2d,
+ * fillActive: 0xfe9727,
+ * strokeActive: 0xfecd2d,
+ * strokeActiveWidth: 4,
+ * textStyle: {
+ * fill: 0x5ec7f8
+ * },
+ * textStyleActive: {
+ * fill: 0x5954d3
+ * },
+ * textStyleLarge: {
+ * fontSize: 36
+ * }
+ * })
+ *
+ * // Create the app and apply the new theme to it
+ * const app = new PIXIApp({
+ * view: canvas,
+ * width: 450,
+ * height: 150,
+ * theme: yellow
+ * }).setup().run()
+ *
+ * @class
+ * @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/theme.html|DocTest}
+ */
+export default class Theme {
+
+ /**
+ * Creates an instance of a Theme.
+ *
+ * @constructor
+ * @param {object} [opts] - An options object to specify to style and behaviour of the theme.
+ * @param {number} [opts.margin=10] - The outer spacing (distance to other objects) from the border.
+ * @param {number} [opts.padding=10] - The inner spacing (distance from icon and/or label) to the border.
+ * @param {number} [opts.radius=4] - The radius used when drawing a rounded rectangle.
+ * @param {number} [opts.fast=0.25] - The duration of time when it has to be fast.
+ * @param {number} [opts.normal=0.5] - The duration of time when it has to be normal.
+ * @param {number} [opts.slow=1] - The duration of time when it has to be slow.
+ * @param {number} [opts.primaryColor=0x5ec7f8] - The primary color of the theme.
+ * @param {number} [opts.color1=0x282828] - The first color of the theme. For example used for the background.
+ * @param {number} [opts.color2=0xf6f6f6] - The second color of the theme. For example used for the border.
+ * @param {number} [opts.fill=color1] - The color of the background as a hex value.
+ * @param {number} [opts.fillAlpha=1] - The alpha value of the background.
+ * @param {number} [opts.fillActive=color1] - The color of the background when activated.
+ * @param {number} [opts.fillActiveAlpha=1] - The alpha value of the background when activated.
+ * @param {number} [opts.stroke=color2] - The color of the border as a hex value.
+ * @param {number} [opts.strokeWidth=0.6] - The width of the border in pixel.
+ * @param {number} [opts.strokeAlpha=1] - The alpha value of the border.
+ * @param {number} [opts.strokeActive=color2] - The color of the border when activated.
+ * @param {number} [opts.strokeActiveWidth=0.6] - The width of the border in pixel when activated.
+ * @param {number} [opts.strokeActiveAlpha=1] - The alpha value of the border when activated.
+ * @param {number} [opts.iconColor=color2] - The color of the icon (set by the tint property) as a hex value.
+ * @param {number} [opts.iconColorActive=colorPrimary] - The color of the icon when activated.
+ * @param {number} [opts.background=color1] - The color of a background for a component (e.g. at the Modal class).
+ * @param {object} [opts.textStyle={}] - A textstyle object for the styling of text. See PIXI.TextStyle
+ * for possible options. Default object:
+ * @param {string} [opts.textStyle.fontFamily="Avenir Next", "Open Sans", "Segoe UI", ...] - The font family.
+ * @param {string} [opts.textStyle.fontWeight=400] - The font weight.
+ * @param {number} [opts.textStyle.fontSize=16] - The font size.
+ * @param {number} [opts.textStyle.fill=color2] - The fill color.
+ * @param {number} [opts.textStyle.stroke=color1] - The stroke color.
+ * @param {number} [opts.textStyle.strokeThickness=0] - The thickness of the stroke.
+ * @param {number} [opts.textStyle.miterLimit=1] - The meter limit.
+ * @param {string} [opts.textStyle.lineJoin=round] - The line join.
+ * @param {object} [opts.textStyleActive=textStyle + {fill: primaryColor}] - A textstyle object which is used
+ * for actived text.
+ * @param {object} [opts.textStyleSmall=textStyle + {fontSize: -= 3}] - A textstyle object which is used for
+ * small text.
+ * @param {object} [opts.textStyleSmallActive=textStyleSmall + {fill: primaryColor}] - A textstyle object which
+ * is used for small actived text.
+ * @param {object} [opts.textStyleLarge=textStyle + {fontSize: += 3}] - A textstyle object which is used for
+ * large text.
+ * @param {object} [opts.textStyleLargeActive=textStyleLarge + {fill: primaryColor}] - A textstyle object which
+ * is used for large actived text.
+ */
+ constructor(opts = {}) {
+
+ const colorPrimary = opts.primaryColor != null ? opts.primaryColor : 0x5ec7f8 // blue
+ const color1 = opts.color1 != null ? opts.color1 : 0x282828 // black
+ const color2 = opts.color2 != null ? opts.color2 : 0xf6f6f6 // white
+
+ this.opts = Object.assign({}, {
+ margin: 12,
+ padding: 12,
+ radius: 4,
+ fast: .25,
+ normal: .5,
+ slow: 1,
+ primaryColor: colorPrimary,
+ color1: color1,
+ color2: color2,
+ fill: color1,
+ fillAlpha: 1,
+ fillActive: color1,
+ fillActiveAlpha: 1,
+ stroke: color2,
+ strokeWidth: .6,
+ strokeAlpha: 1,
+ strokeActive: color2,
+ strokeActiveWidth: .6,
+ strokeActiveAlpha: 1,
+ iconColor: color2,
+ iconColorActive: colorPrimary,
+ background: color1
+ }, opts)
+
+ // Set textStyle and variants
+ this.opts.textStyle = Object.assign({}, {
+ fontFamily: '"Avenir Next", "Open Sans", "Segoe UI", "Roboto", "Helvetica Neue", -apple-system, system-ui, BlinkMacSystemFont, Arial, sans-serif !default',
+ fontWeight: '500',
+ fontSize: 18,
+ fill: color2,
+ stroke: color1,
+ strokeThickness: 0,
+ miterLimit: 1,
+ lineJoin: 'round'
+ }, this.opts.textStyle)
+ this.opts.textStyleSmall = Object.assign({}, this.opts.textStyle, {fontSize: this.opts.textStyle.fontSize - 3}, this.opts.textStyleSmall)
+ this.opts.textStyleLarge = Object.assign({}, this.opts.textStyle, {fontSize: this.opts.textStyle.fontSize + 3}, this.opts.textStyleLarge)
+ this.opts.textStyleActive = Object.assign({}, this.opts.textStyle, {fill: this.opts.primaryColor}, this.opts.textStyleActive)
+ this.opts.textStyleSmallActive = Object.assign({}, this.opts.textStyleSmall, {fill: this.opts.primaryColor}, this.opts.textStyleSmallActive)
+ this.opts.textStyleLargeActive = Object.assign({}, this.opts.textStyleLarge, {fill: this.opts.primaryColor}, this.opts.textStyleLargeActive)
+
+ Object.assign(this, this.opts)
+ }
+
+ /**
+ * Factory function
+ *
+ * @static
+ * @param {string} theme=dark - The name of the theme to load.
+ * @return {Theme} Returns a newly created Theme object.
+ */
+ static fromString(theme) {
+
+ if (theme && typeof theme === 'object') {
+ return theme
+ }
+
+ switch (theme) {
+ case 'light':
+ return new ThemeLight()
+ case 'red':
+ return new ThemeRed()
+ default:
+ return new ThemeDark()
+ }
+ }
+}
+
+/**
+ * Class that represents a PixiJS ThemeDark.
+ *
+ * @example
+ * // Create the app with a new dark theme
+ * const app = new PIXIApp({
+ * view: canvas,
+ * width: 450,
+ * height: 150,
+ * theme: new ThemeDark()
+ * }).setup().run()
+ *
+ * @class
+ * @extends Theme
+ * @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/theme.html|DocTest}
+ */
+export class ThemeDark extends Theme {
+
+}
+
+/**
+ * Class that represents a PixiJS ThemeLight.
+ * The color1 is set to 0xf6f6f6, color2 to 0x282828.
+ *
+ * @example
+ * // Create the app with a new light theme
+ * const app = new PIXIApp({
+ * view: canvas,
+ * width: 450,
+ * height: 150,
+ * theme: new ThemeLight()
+ * }).setup().run()
+ *
+ * @class
+ * @extends Theme
+ * @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/theme.html|DocTest}
+ */
+export class ThemeLight extends Theme {
+
+ /**
+ * Creates an instance of a ThemeLight.
+ *
+ * @constructor
+ */
+ constructor() {
+
+ super({color1: 0xf6f6f6, color2: 0x282828})
+ }
+}
+
+/**
+ * Class that represents a PixiJS ThemeRed.
+ * The primaryColor is set to 0xd92f31.
+ *
+ * @example
+ * // Create the app with a new red theme
+ * const app = new PIXIApp({
+ * view: canvas,
+ * width: 450,
+ * height: 150,
+ * theme: new ThemeRed()
+ * }).setup().run()
+ *
+ * @class
+ * @extends Theme
+ * @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/theme.html|DocTest}
+ */
+export class ThemeRed extends Theme {
+
+ /**
+ * Creates an instance of a ThemeRed.
+ *
+ * @constructor
+ */
+ constructor() {
+
+ super({primaryColor: 0xd92f31})
+ }
+}
+
/* globals Power0 */
+/* eslint no-console: ["error", { allow: ["log", "info", "warn", "error"] }] */
+
+/**
+ * Imports
+ */
+
+/**
+ * A class that can be used to perform automated user interface tests.
+ *
+ * @example
+ * // Create the UITest object
+ * const test = new UITest({
+ * timeScale: 2
+ * })
+ *
+ * // Add an action to the test case
+ * test.tap(button, {eventType: 'click'})
+ *
+ * // Start the test case
+ * test.start()
+ *
+ * @class
+ * @see {@link https://www.iwm-tuebingen.de/iwmbrowser/lib/pixi/uitest.html|DocTest}
+ */
+export default class UITest {
+
+ /**
+ * Creates an instance of an UITest.
+ *
+ * In the background, the class UITest uses the Greensock TimelineMax class. The opts object is passed directly to the TimelineMax class, so it can use any key that uses the TimelineMax class.
+ *
+ * @constructor
+ * @param {object} [opts] - An options object to specify the behaviour of the test case.
+ * @param {number} [opts.timeScale=1] - The speed at which the test should run, see https://greensock.com/docs/TimelineMax/timeScale().
+ * @param {string} [opts.eventType=auto] - The type of events which should be used. Possible values: pointer, touch, mouse, auto. If set to auto, the eventType is set depending on the support of the browser used.
+ * @param {boolean} [opts.debug=false] - If set to true, multiple informations will be print to the console.
+ * @param {number} [opts.defaultInterval] - The interval used when no action is specified for an action.
+ */
+ constructor(opts = {}) {
+
+ this.opts = Object.assign({}, {
+ timeScale: 1,
+ eventType: 'auto',
+ debug: false,
+ defaultInterval: null
+ }, opts)
+
+ // timeline
+ //--------------------
+ this._timeline = new TimelineMax(Object.assign({}, {
+ paused: true
+ }, this.opts))
+ this._timeline.timeScale(this.opts.timeScale)
+
+ // eventType
+ //--------------------
+ if (this.opts.eventType === 'auto') {
+ if (window.PointerEvent) {
+ this.opts.eventType = 'pointer'
+ } else if ('ontouchstart' in window) {
+ this.opts.eventType = 'touch'
+ } else {
+ this.opts.eventType = 'mouse'
+ }
+ }
+
+ if (this.opts.debug) {
+ console.log(`Event type: ${this.opts.eventType}`)
+ }
+
+ this._timelinePositions = [0]
+ this._actions = 0
+
+ // setup
+ //-----------------
+ this.setup()
+ }
+
+ /**
+ * Generates the required structure.
+ *
+ * @private
+ * @return {UITest} A reference to the UITest for chaining.
+ */
+ setup() {
+ return this
+ }
+
+ /**
+ * Gets the Greensock TimelineMax object, used in the background of UITest.
+ *
+ * @member {TimelineMax}
+ */
+ get timeline() {
+ return this._timeline
+ }
+
+ /**
+ * Starts the test case and executes the corresponding statements in the specified order.
+ *
+ * @return {UITest} A reference to the UITest for chaining.
+ */
+ start() {
+ this._timeline.play()
+ return this
+ }
+
+ /**
+ * Stops the test case and stops executing any further instructions.
+ *
+ * @return {UITest} A reference to the UITest for chaining.
+ */
+ stop() {
+ this._timeline.pause()
+ return this
+ }
+
+ /**
+ * Clears all instructions of the test case.
+ *
+ * @return {UITest} A reference to the UITest for chaining.
+ */
+ clear() {
+ this._timeline.clear()
+ return this
+ }
+
+ /**
+ * Restarts the test case.
+ *
+ * @return {UITest} A reference to the UITest for chaining.
+ */
+ restart() {
+ this._timeline.restart()
+ return this
+ }
+
+ /**
+ * Executes a tap event (pointerdown, pointerup) on a specific element.
+ *
+ * @param {HTMLElement|string} element - The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
+ * @param {number[]|object|PIXI.DisplayObject} [position=The center of the element.] - The local position of the event in the context of the specified HTML element. If no position is specified, the center of the HTML element is used. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+ * @param {number} [timelinePosition=One second after the last action.] - The position in seconds when the event should be triggered, see shttps://greensock.com/docs/TimelineMax/addCallback().
+ * @param {object} [opts] - An options object to specify the behaviour of the action.
+ * @param {function} [opts.onStart] - A function that runs after the first event is fired. Will not be fired if only one event is running (for example, a click event). Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {function} [opts.onComplete] - A function that runs after the second event is fired. Always fired, even if only one event is running (for example, a click event). Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {string[]} [opts.eventTypes=['pointerdown', 'pointerup']] - The event types to use. If no types are specified, the event types specified in the UITest constructor are used (or auto if not specified).
+ * @param {string} [opts.eventType] - If you want the tap method to fire only one event (for example, a click event), you can specify the opts.eventType parameter. If eventType is not null, the parameter opts.eventTypes is ignored.
+ * @param {Window|Frame} [opts.context=window] - The context within which the optionally specified element selector should be executed.
+ * @param {boolean} [opts.bubbles=true] - The Event property bubbles indicates whether the event bubbles up through the DOM or not.
+ * @param {boolean} [opts.cancelable=true] - Events' cancelable property indicates if the event can be canceled, and therefore prevented as if the event never happened. If the event is not cancelable, then its cancelable property will be false and the event listener cannot stop the event from occurring.
+ */
+ tap(element, position, timelinePosition, opts = {}) {
+
+ // arguments
+ //--------------------
+ [position, timelinePosition, opts] = this.reorderArguments(arguments)
+ this._timelinePositions.push(timelinePosition)
+
+ // debug
+ //--------------------
+ if (this.opts.debug) console.log('tap params', {element, position, timelinePosition, opts})
+
+ // opts
+ //--------------------
+ opts = Object.assign({}, {
+ onStart: null,
+ onComplete: null,
+ eventTypes: this.resolveEvents(['down', 'up']),
+ eventType: null,
+ context: window,
+ bubbles: true,
+ cancelable: true
+ }, opts)
+
+ if (opts.eventType) {
+ opts.eventTypes = opts.eventType
+ }
+ opts.eventTypes = Array.isArray(opts.eventTypes) ? opts.eventTypes : [opts.eventTypes]
+
+ // timeline
+ //--------------------
+ this._timeline.addCallback(position => {
+
+ // element
+ //--------------------
+ const elem = Util.extractElement(opts.context, element)
+
+ // position
+ //--------------------
+ if (position === null) {
+ const rect = elem.getBoundingClientRect()
+ position = [rect.width / 2, rect.height / 2]
+ }
+
+ // coords
+ //--------------------
+ const coords = Util.extractPosition(position)
+ if (this.opts.debug) console.log('local coords', coords)
+
+ // eventTypes
+ //--------------------
+ if (opts.eventTypes.length === 1) {
+ opts.eventTypes.unshift(null)
+ }
+
+ // event opts
+ //--------------------
+ const eventOpts = {bubbles: opts.bubbles, cancelable: opts.cancelable}
+
+ if (opts.eventTypes[0]) {
+
+ // create and dispatch event
+ //--------------------
+ const eventStart = Event.create(elem, coords, opts.eventTypes[0], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', eventStart)
+ elem.dispatchEvent(eventStart)
+
+ // onStart
+ //--------------------
+ if (opts.onStart) {
+ opts.onStart.call(this, eventStart)
+ }
+ }
+
+ // create and dispatch event
+ //--------------------
+ const eventComplete = Event.create(elem, coords, opts.eventTypes[1], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', eventComplete)
+ elem.dispatchEvent(eventComplete)
+
+ // onComplete
+ //--------------------
+ if (opts.onComplete) {
+ opts.onComplete.call(this, eventComplete)
+ }
+
+ }, timelinePosition, [position])
+
+ this._actions++
+
+ return this
+ }
+
+ /**
+ * Executes a pan event (pointerdown, pointermove, pointerup) on a specific element.
+ *
+ * @param {HTMLElement|string} element - The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
+ * @param {number[]|object|PIXI.DisplayObject} [position=The center of the element.] - The local position of the event in the context of the specified HTML element. If no position is specified, the center of the HTML element is used. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+ * @param {number} [timelinePosition=One second after the last action.] - The position in seconds when the event should be triggered, see shttps://greensock.com/docs/TimelineMax/addCallback().
+ * @param {object} [opts] - An options object to specify the behaviour of the action.
+ * @param {function} [opts.onStart] - A function that runs after the first event is fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {function} [opts.onUpdate] - A function that runs after each execution of the second event. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {function} [opts.onComplete] - A function that runs after the third event is fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {number[]|object|PIXI.DisplayObject} [opts.to={x: 0, y: 0}] - The target of the pan process. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+ * @param {number} [opts.duration=1] - The duration of the pan animation in seconds, see https://greensock.com/docs/TweenLite/duration().
+ * @param {Ease} [opts.ease=Power0.easeNone] - The easing of the pan animation, see https://greensock.com/docs/Easing.
+ * @param {string[]} [opts.eventTypes=['pointerdown', 'pointermove', 'pointerup']] - The event types to use. If no types are specified, the event types specified in the UITest constructor are used (or auto if not specified).
+ * @param {Window|Frame} [opts.context=window] - The context within which the optionally specified element selector should be executed.
+ * @param {boolean} [opts.bubbles=true] - The Event property bubbles indicates whether the event bubbles up through the DOM or not.
+ * @param {boolean} [opts.cancelable=true] - Events' cancelable property indicates if the event can be canceled, and therefore prevented as if the event never happened. If the event is not cancelable, then its cancelable property will be false and the event listener cannot stop the event from occurring.
+ */
+ pan(element, position, timelinePosition, opts = {}) {
+
+ // arguments
+ //--------------------
+ [position, timelinePosition, opts] = this.reorderArguments(arguments)
+ this._timelinePositions.push(timelinePosition)
+
+ // debug
+ //--------------------
+ if (this.opts.debug) console.log('tap params', {element, position, timelinePosition, opts})
+
+ // opts
+ //--------------------
+ opts = Object.assign({}, {
+ onStart: null,
+ onUpdate: null,
+ onComplete: null,
+ to: {x: 0, y: 0},
+ duration: 1,
+ ease: Power0.easeNone,
+ eventTypes: this.resolveEvents(['down', 'move', 'up']),
+ context: window,
+ bubbles: true,
+ cancelable: true
+ }, opts)
+
+ // timeline
+ //--------------------
+ this._timeline.addCallback(position => {
+
+ // element
+ //--------------------
+ const elem = Util.extractElement(opts.context, element)
+
+ // coords
+ //--------------------
+ const from = Util.extractPosition(position)
+
+ // event opts
+ //--------------------
+ const eventOpts = {bubbles: opts.bubbles, cancelable: opts.cancelable}
+
+ const gsOpts = {
+ ease: opts.ease,
+ onStart: () => {
+
+ // create and dispatch event
+ //--------------------
+ const event = Event.create(elem, from, opts.eventTypes[0], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', event)
+ elem.dispatchEvent(event)
+
+ // onStart
+ //--------------------
+ if (opts.onStart) {
+ opts.onStart.call(this, event)
+ }
+ },
+ onUpdate: () => {
+
+ // create and dispatch event
+ //--------------------
+ const event = Event.create(elem, from, opts.eventTypes[1], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', event)
+ elem.dispatchEvent(event)
+
+ // onUpdate
+ //--------------------
+ if (opts.onUpdate) {
+ opts.onUpdate.call(this, event)
+ }
+ },
+ onComplete: () => {
+
+ // create and dispatch event
+ //--------------------
+ const event = Event.create(elem, from, opts.eventTypes[2], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', event)
+ elem.dispatchEvent(event)
+
+ // onComplete
+ //--------------------
+ if (opts.onComplete) {
+ opts.onComplete.call(this, event)
+ }
+ }
+ }
+
+ // to
+ //--------------------
+ const object = Util.extractTo(opts)
+ Object.assign(gsOpts, object)
+
+ // drag animation
+ //--------------------
+ TweenLite.to(from, opts.duration, gsOpts)
+
+ }, timelinePosition, [position])
+
+ this._actions++
+
+ return this
+ }
+
+ /**
+ * Executes a pinch event (pointerdown, pointermove, pointerup) on a specific element with two "fingers" simultaneously.
+ *
+ * @param {HTMLElement|string} element - The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
+ * @param {number[]|object|PIXI.DisplayObject} [position=The center of the element.] - The local position of the event in the context of the specified HTML element. If no position is specified, the center of the HTML element is used. The position can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object.
+ * @param {number} [timelinePosition=One second after the last action.] - The position in seconds when the event should be triggered, see shttps://greensock.com/docs/TimelineMax/addCallback().
+ * @param {object} [opts] - An options object to specify the behaviour of the action.
+ * @param {function} [opts.onStart] - A function that runs after the first events are fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {function} [opts.onUpdate] - A function that runs after each execution of the second events. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {function} [opts.onComplete] - A function that runs after the third events are fired. Receives the fired event object as the first parameter. The test case (UITest) is bound to this.
+ * @param {boolean} [opts.doubleCallbacks=false] - The callbacks onStart, onUpdate and onComplete will be fired only for one finger. If set to true, the events will be fired for both fingers.
+ * @param {number} [opts.distance=100] - The distance in pixels, how far the two "fingers" should move apart. If to or bezier specified, distance is ignored.
+ * @param {number[][]|object[]|PIXI.DisplayObject[]} [opts.to] - The targets of the pinch process. The position must be an array with two entries. An entry can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object. If bezier is specified, to is ignored.
+ * @param {number[][]|object[]|PIXI.DisplayObject[]} [opts.bezier] - The targets of the pinch process. The position must be an array with two entries. An entry may be an array of positions or a bezier object (https://greensock.com/docs/Plugins/BezierPlugin). A position in the array or the values array of the bezier object can be specified as an array of numbers, as an object with the two properties x and y, or as a PIXI.Display object. If bezier is specified, to is ignored.
+ * @param {number} [opts.duration=1] - The duration of the pan animation in seconds, see https://greensock.com/docs/TweenLite/duration().
+ * @param {Ease} [opts.ease=Power0.easeNone] - The easing of the pan animation, see https://greensock.com/docs/Easing.
+ * @param {string[]} [opts.eventTypes=['pointerdown', 'pointermove', 'pointerup']] - The event types to use. If no types are specified, the event types specified in the UITest constructor are used (or auto if not specified).
+ * @param {Window|Frame} [opts.context=window] - The context within which the optionally specified element selector should be executed.
+ * @param {boolean} [opts.bubbles=true] - The Event property bubbles indicates whether the event bubbles up through the DOM or not.
+ * @param {boolean} [opts.cancelable=true] - Events' cancelable property indicates if the event can be canceled, and therefore prevented as if the event never happened. If the event is not cancelable, then its cancelable property will be false and the event listener cannot stop the event from occurring.
+ */
+ pinch(element, position, timelinePosition, opts = {}) {
+
+ // arguments
+ //--------------------
+ [position, timelinePosition, opts] = this.reorderArguments(arguments)
+ this._timelinePositions.push(timelinePosition)
+
+ // debug
+ //--------------------
+ if (this.opts.debug) console.log('tap params', {element, position, timelinePosition, opts})
+
+ // opts
+ //--------------------
+ opts = Object.assign({}, {
+ onStart: null,
+ onUpdate: null,
+ onComplete: null,
+ doubleCallbacks: false,
+ duration: 1,
+ distance: 100,
+ to: null,
+ bezier: null,
+ ease: Power0.easeNone,
+ eventTypes: this.resolveEvents(['down', 'move', 'up']),
+ context: window,
+ bubbles: true,
+ cancelable: true
+ }, opts)
+
+ // timeline
+ //--------------------
+ this._timeline.addCallback(position => {
+
+ // element
+ //--------------------
+ const elem = Util.extractElement(opts.context, element)
+
+ // from
+ //--------------------
+ let from1 = null
+ let from2 = null
+
+ if (Array.isArray(position) && !Util.isNumber(position[0])) {
+ from1 = Util.extractPosition(position[0])
+ from2 = Util.extractPosition(position[1])
+ } else {
+ from1 = Util.extractPosition(position)
+ from2 = {x: from1.x, y: from1.y}
+ }
+
+ // to
+ //--------------------
+ let gsOpts1 = {}
+ let gsOpts2 = {}
+
+ if (opts.to || opts.bezier) {
+ [gsOpts1, gsOpts2] = Util.extractMultiTo(opts)
+ } else {
+ const distance = opts.distance != null ? opts.distance : 100
+ gsOpts1.x = from1.x - distance / 2
+ gsOpts1.y = from1.y
+ gsOpts2.x = from2.x + distance / 2
+ gsOpts2.y = from2.y
+ }
+
+ // pointers
+ //--------------------
+ const pointers = new Map()
+ pointers.set(0, {element: from1, gsOpts: gsOpts1})
+ pointers.set(1, {element: from2, gsOpts: gsOpts2})
+
+ // loop
+ //--------------------
+ pointers.forEach((value, key) => {
+
+ // from
+ //--------------------
+ const from = value.element
+
+ // event opts
+ //--------------------
+ const eventOpts = {bubbles: opts.bubbles, cancelable: opts.cancelable, pointerId: key, isPrimary: key === 0}
+
+ const gsOpts = {
+ ease: opts.ease,
+ onStart: () => {
+
+ // create and dispatch event
+ //--------------------
+ const event = Event.create(elem, from, opts.eventTypes[0], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', event)
+ elem.dispatchEvent(event)
+
+ // onStart
+ //--------------------
+ if (opts.onStart && (opts.doubleCallbacks || key === 0)) {
+ opts.onStart.call(this, event)
+ }
+ },
+ onUpdate: () => {
+
+ // create and dispatch event
+ //--------------------
+ const event = Event.create(elem, from, opts.eventTypes[1], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', event)
+ elem.dispatchEvent(event)
+
+ // onUpdate
+ //--------------------
+ if (opts.onUpdate && (opts.doubleCallbacks || key === 0)) {
+ opts.onUpdate.call(this, event)
+ }
+ },
+ onComplete: () => {
+
+ // create and dispatch event
+ //--------------------
+ const event = Event.create(elem, from, opts.eventTypes[2], eventOpts)
+ if (this.opts.debug) console.log('dispatch event', event)
+ elem.dispatchEvent(event)
+
+ // onComplete
+ //--------------------
+ if (opts.onComplete && (opts.doubleCallbacks || key === 0)) {
+ opts.onComplete.call(this, event)
+ }
+ }
+ }
+
+ // to
+ //--------------------
+ Object.assign(gsOpts, value.gsOpts)
+
+ // drag animation
+ //--------------------
+ TweenLite.to(from, opts.duration, gsOpts)
+ })
+
+ }, timelinePosition, [position])
+
+ this._actions++
+
+ return this
+ }
+
+ // /**
+ // * Adds a tap event to the timeline.
+ // *
+ // * @return {UITest} A reference to the uitest for chaining.
+ // */
+ // rotate() {
+ // return this
+ // }
+
+ // /**
+ // * Adds a tap event to the timeline.
+ // *
+ // * @return {UITest} A reference to the uitest for chaining.
+ // */
+ // swipe() {
+ // return this
+ // }
+
+ // /**
+ // * Adds a tap event to the timeline.
+ // *
+ // * @return {UITest} A reference to the uitest for chaining.
+ // */
+ // press() {
+ // return this
+ // }
+
+ // /**
+ // * Adds a tap event to the timeline.
+ // *
+ // * @return {UITest} A reference to the uitest for chaining.
+ // */
+ // event() {
+ // return this
+ // }
+
+ /**
+ * Sorts the parameters so that the second, third, and fourth parameters can be optional (and possibly slip forward).
+ *
+ * @private
+ * @param {arguments} params - The arguments which were passed to the function.
+ * @returns {array} - Returns an array of the position, the timelinePosition and the opts object.
+ */
+ reorderArguments(params) {
+
+ // first parameter
+ //--------------------
+ const element = params[0]
+
+ // other parameter
+ //--------------------
+ let position = null
+ let timelinePosition = null
+ let opts = null
+
+ // second parameter
+ //--------------------
+ if (Util.isNumber(params[1])) {
+ timelinePosition = params[1]
+ } else if (Util.isObject(params[1]) && !Util.isPixiDisplayObject(params[1]) && (params[1].x == null || params[1].y == null)) {
+ opts = params[1]
+ } else if (params[1] != null) {
+ position = params[1]
+ }
+
+ // third parameter
+ //--------------------
+ if (Util.isNumber(params[2])) {
+ timelinePosition = params[2]
+ } else if (Util.isObject(params[2])) {
+ opts = params[2]
+ }
+
+ // fourth parameter
+ //--------------------
+ if (Util.isObject(params[3])) {
+ opts = params[3]
+ }
+
+ // defaults
+ //--------------------
+ if (position === null) {
+ // will later be filled...
+ }
+
+ if (timelinePosition === null) {
+ if (this.opts.defaultInterval === null && this._actions > 1) {
+ throw new Error('No execution time was specified for this action, and a default interval was not set in the class constructor!')
+ }
+ timelinePosition = Math.max(...this._timelinePositions) + (this.opts.defaultInterval || 1)
+ }
+
+ if (opts === null) {
+ opts = {}
+ }
+
+ return [position, timelinePosition, opts]
+ }
+
+ /**
+ * Converts event type shortcuts to real event names.
+ *
+ * @private
+ * @param {string[]} events - An array of event types.
+ */
+ resolveEvents(events) {
+
+ const data = []
+
+ if (this.opts.eventType === 'pointer') {
+ events.forEach(it => {
+ if (it === 'down') {
+ data.push('pointerdown')
+ } else if (it === 'move') {
+ data.push('pointermove')
+ } else if (it === 'up') {
+ data.push('pointerup')
+ }
+ })
+ } else if (this.opts.eventType === 'touch') {
+ events.forEach(it => {
+ if (it === 'down') {
+ data.push('touchstart')
+ } else if (it === 'move') {
+ data.push('touchmove')
+ } else if (it === 'up') {
+ data.push('touchend')
+ }
+ })
+ } else {
+ events.forEach(it => {
+ if (it === 'down') {
+ data.push('mousedown')
+ } else if (it === 'move') {
+ data.push('mousemove')
+ } else if (it === 'up') {
+ data.push('mouseup')
+ }
+ })
+ }
+
+ return data
+ }
+}
+
+/**
+ * Helper class.
+ *
+ * @example
+ * // Checks if a thing is a number.
+ * const num = Util.isNumber(20)
+ *
+ * @private
+ * @ignore
+ * @class
+ */
+class Util {
+
+ /**
+ * Resolves the element from a specific context.
+ *
+ * @static
+ * @param {Window|Frame} context - The context within which the optionally specified element selector should be executed.
+ * @return {HTMLElement|string} element - The HTML element on which the event is to be executed, e.g. button, document, h2, canvas, etc. or an selector string. If a selector has been specified, it is evaluated immediately before the event is called using the querySelector method.
+ */
+ static extractElement(context, element) {
+
+ const cont = Util.isFrame(context) ? context.contentDocument : context.document
+ const elem = Util.isString(element) ? cont.querySelector(element) : element
+
+ return elem
+ }
+
+ /**
+ * Extracts the position of the second parameter.
+ *
+ * @static
+ * @param {object} object - Something were the coords should be extracted.
+ * @return {object} - Returns an object with the keys x and y.
+ */
+ static extractPosition(object) {
+
+ // event coords
+ //--------------------
+ const position = {x: 0, y: 0}
+
+ // get the position
+ //--------------------
+ if (!object) {
+ position.x = 0
+ position.y = 0
+ } else if (typeof object.getBounds === 'function') {
+ const bounds = object.getBounds()
+ position.x = bounds.x + bounds.width / 2
+ position.y = bounds.y + bounds.height / 2
+ } else if (Array.isArray(object)) {
+ position.x = object[0]
+ position.y = object[1]
+ } else if (object.x != null && object.y != null) {
+ position.x = object.x
+ position.y = object.y
+ }
+
+ return position
+ }
+
+ /**
+ * Extracts the to or bezier key.
+ *
+ * @static
+ * @param {object} opts - An options object where to or bezier should be extracted.
+ * @return {object} - Returns an object with the to or bezier keys.
+ */
+ static extractTo(opts) {
+
+ const object = {}
+
+ if (opts.bezier) {
+
+ let bezier = null
+
+ if (Array.isArray(opts.bezier)) {
+ bezier = {
+ values: opts.bezier.map(it => Util.extractPosition(it)),
+ type: 'thru'
+ }
+ } else {
+ opts.bezier.values = opts.bezier.values.map(it => Util.extractPosition(it))
+ bezier = opts.bezier
+ }
+
+ object.bezier = bezier
+ } else {
+ const to = Util.extractPosition(opts.to)
+ object.x = to.x
+ object.y = to.y
+ }
+
+ return object
+ }
+
+ /**
+ * Extracts multiple to or bezier keys.
+ *
+ * @static
+ * @param {object} opts - An options object where to or bezier should be extracted.
+ * @return {object[]} - Returns an array of objects with the keys x and y.
+ */
+ static extractMultiTo(opts) {
+
+ const objects = []
+
+ if (opts.bezier) {
+
+ opts.bezier.forEach(it => {
+
+ let bezier = null
+
+ if (Array.isArray(it)) {
+ bezier = {
+ values: it.map(it => Util.extractPosition(it)),
+ type: 'thru'
+ }
+ } else {
+ it.values = it.values.map(it => Util.extractPosition(it))
+ bezier = it
+ }
+
+ objects.push({
+ bezier
+ })
+ })
+
+ } else {
+
+ opts.to.forEach(it => {
+ const to = Util.extractPosition(it)
+ objects.push({
+ x: to.x,
+ y: to.y
+ })
+ })
+ }
+
+ return objects
+ }
+
+ /**
+ * Checks if a thing is a string.
+ *
+ * @static
+ * @param {object} object - The object to test for.
+ * @return {boolean} - true if the thing is a string, otherwise false.
+ */
+ static isString(object) {
+ return typeof object === 'string'
+ }
+
+ /**
+ * Checks if a thing is a number.
+ *
+ * @static
+ * @param {object} object - The object to test for.
+ * @return {boolean} - true if the thing is a number, otherwise false.
+ */
+ static isNumber(object) {
+ return typeof object === 'number'
+ }
+
+ /**
+ * Checks if a thing is an object.
+ *
+ * @static
+ * @param {object} object - The object to test for.
+ * @return {boolean} - true if the thing is an object, otherwise false.
+ */
+ static isObject(object) {
+ return typeof object === 'object' && !Array.isArray(object)
+ }
+
+ /**
+ * Checks if a thing is an PIXI.DisplayObject.
+ *
+ * @static
+ * @param {object} object - The object to test for.
+ * @return {boolean} - true if the thing is a PIXI.DisplayObject, otherwise false.
+ */
+ static isPixiDisplayObject(object) {
+ return typeof object.getBounds === 'function' && typeof object.renderWebGL === 'function' && typeof object.setTransform === 'function'
+ }
+
+ /**
+ * Checks if a thing is a frame.
+ *
+ * @static
+ * @param {object} object - The object to test for.
+ * @return {boolean} - true if the thing is a frame, otherwise false.
+ */
+ static isFrame(object) {
+ return object.contentDocument != null
+ }
+}
+
+/**
+ * Event helper class.
+ *
+ * @example
+ * // Creates an event object.
+ * const event = Event.create(h2, {x: 5, y: 10}, 'touchstart')
+ *
+ * @private
+ * @ignore
+ * @class
+ */
+class Event {
+
+ /**
+ * Creates an event object.
+ *
+ * @static
+ * @param {HTMLElement} target - The element on which the event should be executed.
+ * @param {object} position - The local position of the event in relation to the target. The object must have the keys x and y.
+ * @param {string} type - The type of the event, see https://developer.mozilla.org/de/docs/Web/Events
+ * @param {object} opts - An options object. Every paramter of the event object can be overridden, see e.g. https://developer.mozilla.org/de/docs/Web/API/MouseEvent for all the properties.
+ */
+ static create(target, position = {x: 0, y: 0}, type = 'pointerup', opts = {}) {
+
+ const rect = typeof target.getBoundingClientRect === 'function' ? target.getBoundingClientRect() : {x: 0, y: 0}
+
+ // EventInit
+ const eventOpts = {
+ bubbles: true,
+ cancelable: true,
+ composed: false
+ }
+
+ // UIEventInit
+ const uiEventOpts = {
+ detail: 0,
+ view: window
+ }
+
+ // MouseEvent
+ const mouseEventOpts = {
+ screenX: window.screenX + target.offsetLeft + position.x,
+ screenY: window.screenY + target.offsetTop + position.y,
+ clientX: rect.x + position.x,
+ clientY: rect.y + position.y,
+ ctrlKey: false,
+ shiftKey: false,
+ altKey: false,
+ metaKey: false,
+ button: 0,
+ buttons: 1,
+ relatedTarget: null,
+ region: null
+ }
+
+ // TouchEvent
+ const touchEventOpts = {
+ touches: [],
+ targetTouches: [],
+ changedTouches: [],
+ ctrlKey: false,
+ shiftKey: false,
+ altKey: false,
+ metaKey: false
+ }
+
+ // PointerEvent
+ const pointerEventOpts = {
+ pointerId: 0,
+ width: 1,
+ height: 1,
+ pressure: 0,
+ tangentialPressure: 0,
+ tiltX: 0,
+ tiltY: 0,
+ twist: 0,
+ pointerType: 'touch',
+ isPrimary: true
+ }
+
+ if (type.startsWith('pointer')) {
+ return new PointerEvent(type, Object.assign({}, eventOpts, uiEventOpts, mouseEventOpts, pointerEventOpts, opts))
+ } else if (type.startsWith('touch')) {
+ return new TouchEvent(type, Object.assign({}, eventOpts, uiEventOpts, touchEventOpts, opts))
+ } else {
+ return new MouseEvent(type, Object.assign({}, eventOpts, uiEventOpts, mouseEventOpts, opts))
+ }
+ }
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/3rdparty/highlight/CHANGES.md b/lib/3rdparty/highlight/CHANGES.md
new file mode 100644
index 0000000..f4caccb
--- /dev/null
+++ b/lib/3rdparty/highlight/CHANGES.md
@@ -0,0 +1,1546 @@
+## Version 9.9.0
+
+New languages
+
+- *LLVM* by [Michael Rodler][]
+
+Improvements:
+
+- *TypeScript* updated with annotations and param lists inside constructors, by
+ [Raphael Parree][].
+- *CoffeeScript* updated with new keywords and fixed to recognize JavaScript
+ in \`\`\`, thanks to thanks to [Geoffrey Booth][].
+- Compiler directives in *Delphi* are now correctly highlighted as "meta".
+
+[Raphael Parree]: https://github.com/rparree
+[Michael Rodler]: https://github.com/f0rki
+[Geoffrey Booth]: https://github.com/GeoffreyBooth
+
+
+## Version 9.8.0 "New York"
+
+This version is the second one that deserved a name. Because I'm in New York,
+and the release isn't missing the deadline only because it's still Tuesday on
+West Coast.
+
+New languages:
+
+- *Clean* by [Camil Staps][]
+- *Flix* by [Magnus Madsen][]
+
+Improvements:
+
+- [Kenton Hamaluik][] did a comprehensive update for *Haxe*.
+- New commands for *PowerShell* from [Nicolas Le Gall][].
+- [Jan T. Sott][] updated *NSIS*.
+- *Java* and *Swift* support unicode characters in identifiers thanks to
+ [Alexander Lichter][].
+
+[Camil Staps]: https://github.com/camilstaps
+[Magnus Madsen]: https://github.com/magnus-madsen
+[Kenton Hamaluik]: https://github.com/FuzzyWuzzie
+[Nicolas Le Gall]: https://github.com/darkitty
+[Jan T. Sott]: https://github.com/idleberg
+[Alexander Lichter]: https://github.com/manniL
+
+
+## Version 9.7.0
+
+A comprehensive bugfix release. This is one of the best things about
+highlight.js: even boring things keep getting better (even if slow).
+
+- VHDL updated with PSL keywords and uses more consistent styling.
+- Nested C-style comments no longer break highlighting in many languages.
+- JavaScript updated with `=>` functions, highlighted object attributes and
+ parsing within template string substitution blocks (`${...}`).
+- Fixed another corner case with self-closing `` in JSX.
+- Added `HEALTHCHECK` directive in Docker.
+- Delphi updated with new Free Pascal keywords.
+- Fixed digit separator parsing in C++.
+- C# updated with new keywords and fixed to allow multiple identifiers within
+ generics `<...>`.
+- Fixed another slow regex in Less.
+
+
+## Version 9.6.0
+
+New languages:
+
+- *ABNF* and *EBNF* by [Alex McKibben][]
+- *Awk* by [Matthew Daly][]
+- *SubUnit* by [Sergey Bronnikov][]
+
+New styles:
+
+- *Atom One* in both Dark and Light variants by [Daniel Gamage][]
+
+Plus, a few smaller updates for *Lasso*, *Elixir*, *C++* and *SQL*.
+
+[Alex McKibben]: https://github.com/mckibbenta
+[Daniel Gamage]: https://github.com/danielgamage
+[Matthew Daly]: https://github.com/matthewbdaly
+[Sergey Bronnikov]: https://github.com/ligurio
+
+
+## Version 9.5.0
+
+New languages:
+
+- *Excel* by [Victor Zhou][]
+- *Linden Scripting Language* by [Builder's Brewery][]
+- *TAP* (Test Anything Protocol) by [Sergey Bronnikov][]
+- *Pony* by [Joe Eli McIlvain][]
+- *Coq* by [Stephan Boyer][]
+- *dsconfig* and *LDIF* by [Jacob Childress][]
+
+New styles:
+
+- *Ocean Dark* by [Gavin Siu][]
+
+Notable changes:
+
+- [Minh Nguyễn][] added more built-ins to Objective C.
+- [Jeremy Hull][] fixed corner cases in C++ preprocessor directives and Diff
+ comments.
+- [Victor Zhou][] added support for digit separators in C++ numbers.
+
+[Gavin Siu]: https://github.com/gavsiu
+[Builder's Brewery]: https://github.com/buildersbrewery
+[Victor Zhou]: https://github.com/OiCMudkips
+[Sergey Bronnikov]: https://github.com/ligurio
+[Joe Eli McIlvain]: https://github.com/jemc
+[Stephan Boyer]: https://github.com/boyers
+[Jacob Childress]: https://github.com/braveulysses
+[Minh Nguyễn]: https://github.com/1ec5
+[Jeremy Hull]: https://github.com/sourrust
+
+
+## Version 9.4.0
+
+New languages:
+
+- *PureBASIC* by [Tristano Ajmone][]
+- *BNF* by [Oleg Efimov][]
+- *Ada* by [Lars Schulna][]
+
+New styles:
+
+- *PureBASIC* by [Tristano Ajmone][]
+
+Improvements to existing languages and styles:
+
+- We now highlight function declarations in Go.
+- [Taisuke Fujimoto][] contributed very convoluted rules for raw and
+ interpolated strings in C#.
+- [Boone Severson][] updated Verilog to comply with IEEE 1800-2012
+ SystemVerilog.
+- [Victor Zhou][] improved rules for comments and strings in PowerShell files.
+- [Janis Voigtländer][] updated the definition of Elm to version 0.17 of the
+ languages. Elm is now featured on the front page of .
+- Special variable `$this` is highlighted as a keyword in PHP.
+- `usize` and `isize` are now highlighted in Rust.
+- Fixed labels and directives in x86 assembler.
+
+[Tristano Ajmone]: https://github.com/tajmone
+[Taisuke Fujimoto]: https://github.com/temp-impl
+[Oleg Efimov]: https://github.com/Sannis
+[Boone Severson]: https://github.com/BooneJS
+[Victor Zhou]: https://github.com/OiCMudkips
+[Lars Schulna]: https://github.com/captain-hanuta
+[Janis Voigtländer]: https://github.com/jvoigtlaender
+
+
+## Version 9.3.0
+
+New languages:
+
+- *Tagger Script* by [Philipp Wolfer][]
+- *MoonScript* by [Billy Quith][]
+
+New styles:
+
+- *xt256* by [Herbert Shin][]
+
+Improvements to existing languages and styles:
+
+- More robust handling of unquoted HTML tag attributes
+- Relevance tuning for QML which was unnecessary eager at seizing other
+ languages' code
+- Improve GAMS language parsing
+- Fixed a bunch of bugs around selectors in Less
+- Kotlin's got a new definition for annotations, updated keywords and other
+ minor improvements
+- Added `move` to Rust keywords
+- Markdown now recognizes \`\`\`-fenced code blocks
+- Improved detection of function declarations in C++ and C#
+
+[Philipp Wolfer]: https://github.com/phw
+[Billy Quith]: https://github.com/billyquith
+[Herbert Shin]: https://github.com/initbar
+
+
+## Version 9.2.0
+
+New languages:
+
+- *QML* by [John Foster][]
+- *HTMLBars* by [Michael Johnston][]
+- *CSP* by [Taras][]
+- *Maxima* by [Robert Dodier][]
+
+New styles:
+
+- *Gruvbox* by [Qeole][]
+- *Dracula* by [Denis Ciccale][]
+
+Improvements to existing languages and styles:
+
+- We now correctly handle JSX with arbitrary node tree depth.
+- Argument list for `(lambda)` in Scheme is no longer highlighted as a function
+ call.
+- Stylus syntax doesn't break on valid CSS.
+- More correct handling of comments and strings and other improvements for
+ VimScript.
+- More subtle work on the default style.
+- We now use anonymous modules for AMD.
+- `macro_rules!` is now recognized as a built-in in Rust.
+
+[John Foster]: https://github.com/jf990
+[Qeole]: https://github.com/Qeole
+[Denis Ciccale]: https://github.com/dciccale
+[Michael Johnston]: https://github.com/lastobelus
+[Taras]: https://github.com/oxdef
+[Robert Dodier]: https://github.com/robert-dodier
+
+
+## Version 9.1.0
+
+New languages:
+
+- *Stan* by [Brendan Rocks][]
+- *BASIC* by [Raphaël Assénat][]
+- *GAUSS* by [Matt Evans][]
+- *DTS* by [Martin Braun][]
+- *Arduino* by [Stefania Mellai][]
+
+New Styles:
+
+- *Arduino Light* by [Stefania Mellai][]
+
+Improvements to existing languages and styles:
+
+- Handle return type annotations in Python
+- Allow shebang headers in Javascript
+- Support strings in Rust meta
+- Recognize `struct` as a class-level definition in Rust
+- Recognize b-prefixed chars and strings in Rust
+- Better numbers handling in Verilog
+
+[Brendan Rocks]: http://brendanrocks.com
+[Raphaël Assénat]: https://github.com/raphnet
+[Matt Evans]: https://github.com/matthewevans
+[Martin Braun]: https://github.com/mbr0wn
+[Stefania Mellai]: https://github.com/smellai
+
+
+## Version 9.0.0
+
+The new major version brings a reworked styling system. Highlight.js now defines
+a limited set of highlightable classes giving a consistent result across all the
+styles and languages. You can read a more detailed explanation and background in
+the [tracking issue][#348] that started this long process back in May.
+
+This change is backwards incompatible for those who uses highlight.js with a
+custom stylesheet. The [new style guide][sg] explains how to write styles
+in this new world.
+
+Bundled themes have also suffered a significant amount of improvements and may
+look different in places, but all the things now consistent and make more sense.
+Among others, the Default style has got a refresh and will probably be tweaked
+some more in next releases. Please do give your feedback in our
+[issue tracker][issues].
+
+New languages in this release:
+
+- *Caché Object Script* by [Nikita Savchenko][]
+- *YAML* by [Stefan Wienert][]
+- *MIPS Assembler* by [Nebuleon Fumika][]
+- *HSP* by [prince][]
+
+Improvements to existing languages and styles:
+
+- ECMAScript 6 modules import now do not require closing semicolon.
+- ECMAScript 6 classes constructors now highlighted.
+- Template string support for Typescript, as for ECMAScript 6.
+- Scala case classes params highlight fixed.
+- Built-in names introduced in Julia v0.4 added by [Kenta Sato][].
+- Refreshed Default style.
+
+Other notable changes:
+
+- [Web workers support][webworkers] added bu [Jan Kühle][].
+- We now have tests for compressed browser builds as well.
+- The building tool chain has been switched to node.js 4.x. and is now
+ shamelessly uses ES6 features all over the place, courtesy of [Jeremy Hull][].
+- License added to non-compressed browser build.
+
+[Jan Kühle]: https://github.com/frigus02
+[Stefan Wienert]: https://github.com/zealot128
+[Kenta Sato]: https://github.com/bicycle1885
+[Nikita Savchenko]: https://github.com/ZitRos
+[webworkers]: https://github.com/isagalaev/highlight.js#web-workers
+[Jeremy Hull]: https://github.com/sourrust
+[#348]: https://github.com/isagalaev/highlight.js/issues/348
+[sg]: http://highlightjs.readthedocs.org/en/latest/style-guide.html
+[issues]: https://github.com/isagalaev/highlight.js/issues
+[Nebuleon Fumika]: https://github.com/Nebuleon
+[prince]: https://github.com/prince-0203
+
+
+## Version 8.9.1
+
+Some last-minute changes reverted due to strange bug with minified browser build:
+
+- Scala case classes params highlight fixed
+- ECMAScript 6 modules import now do not require closing semicolon
+- ECMAScript 6 classes constructors now highlighted
+- Template string support for Typescript, as for ECMAScript 6
+- License added to not minified browser build
+
+
+## Version 8.9.0
+
+New languages:
+
+- *crmsh* by [Kristoffer Gronlund][]
+- *SQF* by [Soren Enevoldsen][]
+
+[Kristoffer Gronlund]: https://github.com/krig
+[Soren Enevoldsen]: https://github.com/senevoldsen90
+
+Notable fixes and improvements to existing languages:
+
+- Added `abstract` and `namespace` keywords to TypeScript by [Daniel Rosenwasser][]
+- Added `label` support to Dockerfile by [Ladislav Prskavec][]
+- Crystal highlighting improved by [Tsuyusato Kitsune][]
+- Missing Swift keywords added by [Nate Cook][]
+- Improve detection of C block comments
+- ~~Scala case classes params highlight fixed~~
+- ~~ECMAScript 6 modules import now do not require closing semicolon~~
+- ~~ECMAScript 6 classes constructors now highlighted~~
+- ~~Template string support for Typescript, as for ECMAScript 6~~
+
+Other notable changes:
+
+- ~~License added to not minified browser build~~
+
+[Kristoffer Gronlund]: https://github.com/krig
+[Søren Enevoldsen]: https://github.com/senevoldsen90
+[Daniel Rosenwasser]: https://github.com/DanielRosenwasser
+[Ladislav Prskavec]: https://github.com/abtris
+[Tsuyusato Kitsune]: https://github.com/MakeNowJust
+[Nate Cook]: https://github.com/natecook1000
+
+
+## Version 8.8.0
+
+New languages:
+
+- *Golo* by [Philippe Charrière][]
+- *GAMS* by [Stefan Bechert][]
+- *IRPF90* by [Anthony Scemama][]
+- *Access logs* by [Oleg Efimov][]
+- *Crystal* by [Tsuyusato Kitsune][]
+
+Notable fixes and improvements to existing languages:
+
+- JavaScript highlighting no longer fails with ES6 default parameters
+- Added keywords `async` and `await` to Python
+- PHP heredoc support improved
+- Allow preprocessor directives within C++ functions
+
+Other notable changes:
+
+- Change versions to X.Y.Z SemVer-compatible format
+- Added ability to build all targets at once
+
+[Philippe Charrière]: https://github.com/k33g
+[Stefan Bechert]: https://github.com/b-pos465
+[Anthony Scemama]: https://github.com/scemama
+[Oleg Efimov]: https://github.com/Sannis
+[Tsuyusato Kitsune]: https://github.com/MakeNowJust
+
+
+## Version 8.7
+
+New languages:
+
+- *Zephir* by [Oleg Efimov][]
+- *Elm* by [Janis Voigtländer][]
+- *XQuery* by [Dirk Kirsten][]
+- *Mojolicious* by [Dotan Dimet][]
+- *AutoIt* by Manh Tuan from [J2TeaM][]
+- *Toml* (ini extension) by [Guillaume Gomez][]
+
+New styles:
+
+- *Hopscotch* by [Jan T. Sott][]
+- *Grayscale* by [MY Sun][]
+
+Notable fixes and improvements to existing languages:
+
+- Fix encoding of images when copied over in certain builds
+- Fix incorrect highlighting of the word "bug" in comments
+- Treat decorators different from matrix multiplication in Python
+- Fix traits inheritance highlighting in Rust
+- Fix incorrect document
+- Oracle keywords added to SQL language definition by [Vadimtro][]
+- Postgres keywords added to SQL language definition by [Benjamin Auder][]
+- Fix registers in x86asm being highlighted as a hex number
+- Fix highlighting for numbers with a leading decimal point
+- Correctly highlight numbers and strings inside of C/C++ macros
+- C/C++ functions now support pointer, reference, and move returns
+
+[Oleg Efimov]: https://github.com/Sannis
+[Guillaume Gomez]: https://github.com/GuillaumeGomez
+[Janis Voigtländer]: https://github.com/jvoigtlaender
+[Jan T. Sott]: https://github.com/idleberg
+[Dirk Kirsten]: https://github.com/dirkk
+[MY Sun]: https://github.com/simonmysun
+[Vadimtro]: https://github.com/Vadimtro
+[Benjamin Auder]: https://github.com/ghost
+[Dotan Dimet]: https://github.com/dotandimet
+[J2TeaM]: https://github.com/J2TeaM
+
+
+## Version 8.6
+
+New languages:
+
+- *C/AL* by [Kenneth Fuglsang][]
+- *DNS zone file* by [Tim Schumacher][]
+- *Ceylon* by [Lucas Werkmeister][]
+- *OpenSCAD* by [Dan Panzarella][]
+- *Inform7* by [Bruno Dias][]
+- *armasm* by [Dan Panzarella][]
+- *TP* by [Jay Strybis][]
+
+New styles:
+
+- *Atelier Cave*, *Atelier Estuary*,
+ *Atelier Plateau* and *Atelier Savanna* by [Bram de Haan][]
+- *Github Gist* by [Louis Barranqueiro][]
+
+Notable fixes and improvements to existing languages:
+
+- Multi-line raw strings from C++11 are now supported
+- Fix class names with dashes in HAML
+- The `async` keyword from ES6/7 is now supported
+- TypeScript functions handle type and parameter complexity better
+- We unified phpdoc/javadoc/yardoc etc modes across all languages
+- CSS .class selectors relevance was dropped to prevent wrong language detection
+- Images is now included to CDN build
+- Release process is now automated
+
+[Bram de Haan]: https://github.com/atelierbram
+[Kenneth Fuglsang]: https://github.com/kfuglsang
+[Louis Barranqueiro]: https://github.com/LouisBarranqueiro
+[Tim Schumacher]: https://github.com/enko
+[Lucas Werkmeister]: https://github.com/lucaswerkmeister
+[Dan Panzarella]: https://github.com/pzl
+[Bruno Dias]: https://github.com/sequitur
+[Jay Strybis]: https://github.com/unreal
+
+
+## Version 8.5
+
+New languages:
+
+- *pf.conf* by [Peter Piwowarski][]
+- *Julia* by [Kenta Sato][]
+- *Prolog* by [Raivo Laanemets][]
+- *Docker* by [Alexis Hénaut][]
+- *Fortran* by [Anthony Scemama][] and [Thomas Applencourt][]
+- *Kotlin* by [Sergey Mashkov][]
+
+New styles:
+
+- *Agate* by [Taufik Nurrohman][]
+- *Darcula* by [JetBrains][]
+- *Atelier Sulphurpool* by [Bram de Haan][]
+- *Android Studio* by [Pedro Oliveira][]
+
+Notable fixes and improvements to existing languages:
+
+- ES6 features in JavaScript are better supported now by [Gu Yiling][].
+- Swift now recognizes body-less method definitions.
+- Single expression functions `def foo, do: ... ` now work in Elixir.
+- More uniform detection of built-in classes in Objective C.
+- Fixes for number literals and processor directives in Rust.
+- HTML `
+ ```
+
+- `tabReplace` and `useBR` that were used in different places are also unified
+ into the global options object and are to be set using `configure(options)`.
+ This function is documented in our [API docs][]. Also note that these
+ parameters are gone from `highlightBlock` and `fixMarkup` which are now also
+ rely on `configure`.
+
+- We removed public-facing (though undocumented) object `hljs.LANGUAGES` which
+ was used to register languages with the library in favor of two new methods:
+ `registerLanguage` and `getLanguage`. Both are documented in our [API docs][].
+
+- Result returned from `highlight` and `highlightAuto` no longer contains two
+ separate attributes contributing to relevance score, `relevance` and
+ `keyword_count`. They are now unified in `relevance`.
+
+Another technically compatible change that nonetheless might need attention:
+
+- The structure of the NPM package was refactored, so if you had installed it
+ locally, you'll have to update your paths. The usual `require('highlight.js')`
+ works as before. This is contributed by [Dmitry Smolin][].
+
+New features:
+
+- Languages now can be recognized by multiple names like "js" for JavaScript or
+ "html" for, well, HTML (which earlier insisted on calling it "xml"). These
+ aliases can be specified in the class attribute of the code container in your
+ HTML as well as in various API calls. For now there are only a few very common
+ aliases but we'll expand it in the future. All of them are listed in the
+ [class reference][cr].
+
+- Language detection can now be restricted to a subset of languages relevant in
+ a given context — a web page or even a single highlighting call. This is
+ especially useful for node.js build that includes all the known languages.
+ Another example is a StackOverflow-style site where users specify languages
+ as tags rather than in the markdown-formatted code snippets. This is
+ documented in the [API reference][] (see methods `highlightAuto` and
+ `configure`).
+
+- Language definition syntax streamlined with [variants][] and
+ [beginKeywords][].
+
+New languages and styles:
+
+- *Oxygene* by [Carlo Kok][]
+- *Mathematica* by [Daniel Kvasnička][]
+- *Autohotkey* by [Seongwon Lee][]
+- *Atelier* family of styles in 10 variants by [Bram de Haan][]
+- *Paraíso* styles by [Jan T. Sott][]
+
+Miscellaneous improvements:
+
+- Highlighting `=>` prompts in Clojure.
+- [Jeremy Hull][] fixed a lot of styles for consistency.
+- Finally, highlighting PHP and HTML [mixed in peculiar ways][php-html].
+- Objective C and C# now properly highlight titles in method definition.
+- Big overhaul of relevance counting for a number of languages. Please do report
+ bugs about mis-detection of non-trivial code snippets!
+
+[API reference]: http://highlightjs.readthedocs.org/en/latest/api.html
+
+[cr]: http://highlightjs.readthedocs.org/en/latest/css-classes-reference.html
+[api docs]: http://highlightjs.readthedocs.org/en/latest/api.html
+[variants]: https://groups.google.com/d/topic/highlightjs/VoGC9-1p5vk/discussion
+[beginKeywords]: https://github.com/isagalaev/highlight.js/commit/6c7fdea002eb3949577a85b3f7930137c7c3038d
+[php-html]: https://twitter.com/highlightjs/status/408890903017689088
+
+[Carlo Kok]: https://github.com/carlokok
+[Bram de Haan]: https://github.com/atelierbram
+[Daniel Kvasnička]: https://github.com/dkvasnicka
+[Dmitry Smolin]: https://github.com/dimsmol
+[Jeremy Hull]: https://github.com/sourrust
+[Seongwon Lee]: https://github.com/dlimpid
+[Jan T. Sott]: https://github.com/idleberg
+
+
+## Version 7.5
+
+A catch-up release dealing with some of the accumulated contributions. This one
+is probably will be the last before the 8.0 which will be slightly backwards
+incompatible regarding some advanced use-cases.
+
+One outstanding change in this version is the addition of 6 languages to the
+[hosted script][d]: Markdown, ObjectiveC, CoffeeScript, Apache, Nginx and
+Makefile. It now weighs about 6K more but we're going to keep it under 30K.
+
+New languages:
+
+- OCaml by [Mehdi Dogguy][mehdid] and [Nicolas Braud-Santoni][nbraud]
+- [LiveCode Server][lcs] by [Ralf Bitter][revig]
+- Scilab by [Sylvestre Ledru][sylvestre]
+- basic support for Makefile by [Ivan Sagalaev][isagalaev]
+
+Improvements:
+
+- Ruby's got support for characters like `?A`, `?1`, `?\012` etc. and `%r{..}`
+ regexps.
+- Clojure now allows a function call in the beginning of s-expressions
+ `(($filter "myCount") (arr 1 2 3 4 5))`.
+- Haskell's got new keywords and now recognizes more things like pragmas,
+ preprocessors, modules, containers, FFIs etc. Thanks to [Zena Treep][treep]
+ for the implementation and to [Jeremy Hull][sourrust] for guiding it.
+- Miscellaneous fixes in PHP, Brainfuck, SCSS, Asciidoc, CMake, Python and F#.
+
+[mehdid]: https://github.com/mehdid
+[nbraud]: https://github.com/nbraud
+[revig]: https://github.com/revig
+[lcs]: http://livecode.com/developers/guides/server/
+[sylvestre]: https://github.com/sylvestre
+[isagalaev]: https://github.com/isagalaev
+[treep]: https://github.com/treep
+[sourrust]: https://github.com/sourrust
+[d]: http://highlightjs.org/download/
+
+
+## New core developers
+
+The latest long period of almost complete inactivity in the project coincided
+with growing interest to it led to a decision that now seems completely obvious:
+we need more core developers.
+
+So without further ado let me welcome to the core team two long-time
+contributors: [Jeremy Hull][] and [Oleg
+Efimov][].
+
+Hope now we'll be able to work through stuff faster!
+
+P.S. The historical commit is [here][1] for the record.
+
+[Jeremy Hull]: https://github.com/sourrust
+[Oleg Efimov]: https://github.com/sannis
+[1]: https://github.com/isagalaev/highlight.js/commit/f3056941bda56d2b72276b97bc0dd5f230f2473f
+
+
+## Version 7.4
+
+This long overdue version is a snapshot of the current source tree with all the
+changes that happened during the past year. Sorry for taking so long!
+
+Along with the changes in code highlight.js has finally got its new home at
+, moving from its cradle on Software Maniacs which it
+outgrew a long time ago. Be sure to report any bugs about the site to
+.
+
+On to what's new…
+
+New languages:
+
+- Handlebars templates by [Robin Ward][]
+- Oracle Rules Language by [Jason Jacobson][]
+- F# by [Joans Follesø][]
+- AsciiDoc and Haml by [Dan Allen][]
+- Lasso by [Eric Knibbe][]
+- SCSS by [Kurt Emch][]
+- VB.NET by [Poren Chiang][]
+- Mizar by [Kelley van Evert][]
+
+[Robin Ward]: https://github.com/eviltrout
+[Jason Jacobson]: https://github.com/jayce7
+[Joans Follesø]: https://github.com/follesoe
+[Dan Allen]: https://github.com/mojavelinux
+[Eric Knibbe]: https://github.com/EricFromCanada
+[Kurt Emch]: https://github.com/kemch
+[Poren Chiang]: https://github.com/rschiang
+[Kelley van Evert]: https://github.com/kelleyvanevert
+
+New style themes:
+
+- Monokai Sublime by [noformnocontent][]
+- Railscasts by [Damien White][]
+- Obsidian by [Alexander Marenin][]
+- Docco by [Simon Madine][]
+- Mono Blue by [Ivan Sagalaev][] (uses a single color hue for everything)
+- Foundation by [Dan Allen][]
+
+[noformnocontent]: http://nn.mit-license.org/
+[Damien White]: https://github.com/visoft
+[Alexander Marenin]: https://github.com/ioncreature
+[Simon Madine]: https://github.com/thingsinjars
+[Ivan Sagalaev]: https://github.com/isagalaev
+
+Other notable changes:
+
+- Corrected many corner cases in CSS.
+- Dropped Python 2 version of the build tool.
+- Implemented building for the AMD format.
+- Updated Rust keywords (thanks to [Dmitry Medvinsky][]).
+- Literal regexes can now be used in language definitions.
+- CoffeeScript highlighting is now significantly more robust and rich due to
+ input from [Cédric Néhémie][].
+
+[Dmitry Medvinsky]: https://github.com/dmedvinsky
+[Cédric Néhémie]: https://github.com/abe33
+
+
+## Version 7.3
+
+- Since this version highlight.js no longer works in IE version 8 and older.
+ It's made it possible to reduce the library size and dramatically improve code
+ readability and made it easier to maintain. Time to go forward!
+
+- New languages: AppleScript (by [Nathan Grigg][ng] and [Dr. Drang][dd]) and
+ Brainfuck (by [Evgeny Stepanischev][bolk]).
+
+- Improvements to existing languages:
+
+ - interpreter prompt in Python (`>>>` and `...`)
+ - @-properties and classes in CoffeeScript
+ - E4X in JavaScript (by [Oleg Efimov][oe])
+ - new keywords in Perl (by [Kirk Kimmel][kk])
+ - big Ruby syntax update (by [Vasily Polovnyov][vast])
+ - small fixes in Bash
+
+- Also Oleg Efimov did a great job of moving all the docs for language and style
+ developers and contributors from the old wiki under the source code in the
+ "docs" directory. Now these docs are nicely presented at
+ .
+
+[ng]: https://github.com/nathan11g
+[dd]: https://github.com/drdrang
+[bolk]: https://github.com/bolknote
+[oe]: https://github.com/Sannis
+[kk]: https://github.com/kimmel
+[vast]: https://github.com/vast
+
+
+## Version 7.2
+
+A regular bug-fix release without any significant new features. Enjoy!
+
+
+## Version 7.1
+
+A Summer crop:
+
+- [Marc Fornos][mf] made the definition for Clojure along with the matching
+ style Rainbow (which, of course, works for other languages too).
+- CoffeeScript support continues to improve getting support for regular
+ expressions.
+- Yoshihide Jimbo ported to highlight.js [five Tomorrow styles][tm] from the
+ [project by Chris Kempson][tm0].
+- Thanks to [Casey Duncun][cd] the library can now be built in the popular
+ [AMD format][amd].
+- And last but not least, we've got a fair number of correctness and consistency
+ fixes, including a pretty significant refactoring of Ruby.
+
+[mf]: https://github.com/mfornos
+[tm]: http://jmblog.github.com/color-themes-for-highlightjs/
+[tm0]: https://github.com/ChrisKempson/Tomorrow-Theme
+[cd]: https://github.com/caseman
+[amd]: http://requirejs.org/docs/whyamd.html
+
+
+## Version 7.0
+
+The reason for the new major version update is a global change of keyword syntax
+which resulted in the library getting smaller once again. For example, the
+hosted build is 2K less than at the previous version while supporting two new
+languages.
+
+Notable changes:
+
+- The library now works not only in a browser but also with [node.js][]. It is
+ installable with `npm install highlight.js`. [API][] docs are available on our
+ wiki.
+
+- The new unique feature (apparently) among syntax highlighters is highlighting
+ *HTTP* headers and an arbitrary language in the request body. The most useful
+ languages here are *XML* and *JSON* both of which highlight.js does support.
+ Here's [the detailed post][p] about the feature.
+
+- Two new style themes: a dark "south" *[Pojoaque][]* by Jason Tate and an
+ emulation of*XCode* IDE by [Angel Olloqui][ao].
+
+- Three new languages: *D* by [Aleksandar Ružičić][ar], *R* by [Joe Cheng][jc]
+ and *GLSL* by [Sergey Tikhomirov][st].
+
+- *Nginx* syntax has become a million times smaller and more universal thanks to
+ remaking it in a more generic manner that doesn't require listing all the
+ directives in the known universe.
+
+- Function titles are now highlighted in *PHP*.
+
+- *Haskell* and *VHDL* were significantly reworked to be more rich and correct
+ by their respective maintainers [Jeremy Hull][sr] and [Igor Kalnitsky][ik].
+
+And last but not least, many bugs have been fixed around correctness and
+language detection.
+
+Overall highlight.js currently supports 51 languages and 20 style themes.
+
+[node.js]: http://nodejs.org/
+[api]: http://softwaremaniacs.org/wiki/doku.php/highlight.js:api
+[p]: http://softwaremaniacs.org/blog/2012/05/10/http-and-json-in-highlight-js/en/
+[pojoaque]: http://web-cms-designs.com/ftopict-10-pojoaque-style-for-highlight-js-code-highlighter.html
+[ao]: https://github.com/angelolloqui
+[ar]: https://github.com/raleksandar
+[jc]: https://github.com/jcheng5
+[st]: https://github.com/tikhomirov
+[sr]: https://github.com/sourrust
+[ik]: https://github.com/ikalnitsky
+
+
+## Version 6.2
+
+A lot of things happened in highlight.js since the last version! We've got nine
+new contributors, the discussion group came alive, and the main branch on GitHub
+now counts more than 350 followers. Here are most significant results coming
+from all this activity:
+
+- 5 (five!) new languages: Rust, ActionScript, CoffeeScript, MatLab and
+ experimental support for markdown. Thanks go to [Andrey Vlasovskikh][av],
+ [Alexander Myadzel][am], [Dmytrii Nagirniak][dn], [Oleg Efimov][oe], [Denis
+ Bardadym][db] and [John Crepezzi][jc].
+
+- 2 new style themes: Monokai by [Luigi Maselli][lm] and stylistic imitation of
+ another well-known highlighter Google Code Prettify by [Aahan Krish][ak].
+
+- A vast number of [correctness fixes and code refactorings][log], mostly made
+ by [Oleg Efimov][oe] and [Evgeny Stepanischev][es].
+
+[av]: https://github.com/vlasovskikh
+[am]: https://github.com/myadzel
+[dn]: https://github.com/dnagir
+[oe]: https://github.com/Sannis
+[db]: https://github.com/btd
+[jc]: https://github.com/seejohnrun
+[lm]: http://grigio.org/
+[ak]: https://github.com/geekpanth3r
+[es]: https://github.com/bolknote
+[log]: https://github.com/isagalaev/highlight.js/commits/
+
+
+## Version 6.1 — Solarized
+
+[Jeremy Hull][jh] has implemented my dream feature — a port of [Solarized][]
+style theme famous for being based on the intricate color theory to achieve
+correct contrast and color perception. It is now available for highlight.js in
+both variants — light and dark.
+
+This version also adds a new original style Arta. Its author pumbur maintains a
+[heavily modified fork of highlight.js][pb] on GitHub.
+
+[jh]: https://github.com/sourrust
+[solarized]: http://ethanschoonover.com/solarized
+[pb]: https://github.com/pumbur/highlight.js
+
+
+## Version 6.0
+
+New major version of the highlighter has been built on a significantly
+refactored syntax. Due to this it's even smaller than the previous one while
+supporting more languages!
+
+New languages are:
+
+- Haskell by [Jeremy Hull][sourrust]
+- Erlang in two varieties — module and REPL — made collectively by [Nikolay
+ Zakharov][desh], [Dmitry Kovega][arhibot] and [Sergey Ignatov][ignatov]
+- Objective C by [Valerii Hiora][vhbit]
+- Vala by [Antono Vasiljev][antono]
+- Go by [Stephan Kountso][steplg]
+
+[sourrust]: https://github.com/sourrust
+[desh]: http://desh.su/
+[arhibot]: https://github.com/arhibot
+[ignatov]: https://github.com/ignatov
+[vhbit]: https://github.com/vhbit
+[antono]: https://github.com/antono
+[steplg]: https://github.com/steplg
+
+Also this version is marginally faster and fixes a number of small long-standing
+bugs.
+
+Developer overview of the new language syntax is available in a [blog post about
+recent beta release][beta].
+
+[beta]: http://softwaremaniacs.org/blog/2011/04/25/highlight-js-60-beta/en/
+
+P.S. New version is not yet available on a Yandex CDN, so for now you have to
+download [your own copy][d].
+
+[d]: /soft/highlight/en/download/
+
+
+## Version 5.14
+
+Fixed bugs in HTML/XML detection and relevance introduced in previous
+refactoring.
+
+Also test.html now shows the second best result of language detection by
+relevance.
+
+
+## Version 5.13
+
+Past weekend began with a couple of simple additions for existing languages but
+ended up in a big code refactoring bringing along nice improvements for language
+developers.
+
+### For users
+
+- Description of C++ has got new keywords from the upcoming [C++ 0x][] standard.
+- Description of HTML has got new tags from [HTML 5][].
+- CSS-styles have been unified to use consistent padding and also have lost
+ pop-outs with names of detected languages.
+- [Igor Kalnitsky][ik] has sent two new language descriptions: CMake & VHDL.
+
+This makes total number of languages supported by highlight.js to reach 35.
+
+Bug fixes:
+
+- Custom classes on `
` tags are not being overridden anymore
+- More correct highlighting of code blocks inside non-`
` containers:
+ highlighter now doesn't insist on replacing them with its own container and
+ just replaces the contents.
+- Small fixes in browser compatibility and heuristics.
+
+[c++ 0x]: http://ru.wikipedia.org/wiki/C%2B%2B0x
+[html 5]: http://en.wikipedia.org/wiki/HTML5
+[ik]: http://kalnitsky.org.ua/
+
+### For developers
+
+The most significant change is the ability to include language submodes right
+under `contains` instead of defining explicit named submodes in the main array:
+
+ contains: [
+ 'string',
+ 'number',
+ {begin: '\\n', end: hljs.IMMEDIATE_RE}
+ ]
+
+This is useful for auxiliary modes needed only in one place to define parsing.
+Note that such modes often don't have `className` and hence won't generate a
+separate `` in the resulting markup. This is similar in effect to
+`noMarkup: true`. All existing languages have been refactored accordingly.
+
+Test file test.html has at last become a real test. Now it not only puts the
+detected language name under the code snippet but also tests if it matches the
+expected one. Test summary is displayed right above all language snippets.
+
+
+## CDN
+
+Fine people at [Yandex][] agreed to host highlight.js on their big fast servers.
+[Link up][l]!
+
+[yandex]: http://yandex.com/
+[l]: http://softwaremaniacs.org/soft/highlight/en/download/
+
+
+## Version 5.10 — "Paris".
+
+Though I'm on a vacation in Paris, I decided to release a new version with a
+couple of small fixes:
+
+- Tomas Vitvar discovered that TAB replacement doesn't always work when used
+ with custom markup in code
+- SQL parsing is even more rigid now and doesn't step over SmallTalk in tests
+
+
+## Version 5.9
+
+A long-awaited version is finally released.
+
+New languages:
+
+- Andrew Fedorov made a definition for Lua
+- a long-time highlight.js contributor [Peter Leonov][pl] made a definition for
+ Nginx config
+- [Vladimir Moskva][vm] made a definition for TeX
+
+[pl]: http://kung-fu-tzu.ru/
+[vm]: http://fulc.ru/
+
+Fixes for existing languages:
+
+- [Loren Segal][ls] reworked the Ruby definition and added highlighting for
+ [YARD][] inline documentation
+- the definition of SQL has become more solid and now it shouldn't be overly
+ greedy when it comes to language detection
+
+[ls]: http://gnuu.org/
+[yard]: http://yardoc.org/
+
+The highlighter has become more usable as a library allowing to do highlighting
+from initialization code of JS frameworks and in ajax methods (see.
+readme.eng.txt).
+
+Also this version drops support for the [WordPress][wp] plugin. Everyone is
+welcome to [pick up its maintenance][p] if needed.
+
+[wp]: http://wordpress.org/
+[p]: http://bazaar.launchpad.net/~isagalaev/+junk/highlight/annotate/342/src/wp_highlight.js.php
+
+
+## Version 5.8
+
+- Jan Berkel has contributed a definition for Scala. +1 to hotness!
+- All CSS-styles are rewritten to work only inside `
` tags to avoid
+ conflicts with host site styles.
+
+
+## Version 5.7.
+
+Fixed escaping of quotes in VBScript strings.
+
+
+## Version 5.5
+
+This version brings a small change: now .ini-files allow digits, underscores and
+square brackets in key names.
+
+
+## Version 5.4
+
+Fixed small but upsetting bug in the packer which caused incorrect highlighting
+of explicitly specified languages. Thanks to Andrew Fedorov for precise
+diagnostics!
+
+
+## Version 5.3
+
+The version to fulfil old promises.
+
+The most significant change is that highlight.js now preserves custom user
+markup in code along with its own highlighting markup. This means that now it's
+possible to use, say, links in code. Thanks to [Vladimir Dolzhenko][vd] for the
+[initial proposal][1] and for making a proof-of-concept patch.
+
+Also in this version:
+
+- [Vasily Polovnyov][vp] has sent a GitHub-like style and has implemented
+ support for CSS @-rules and Ruby symbols.
+- Yura Zaripov has sent two styles: Brown Paper and School Book.
+- Oleg Volchkov has sent a definition for [Parser 3][p3].
+
+[1]: http://softwaremaniacs.org/forum/highlightjs/6612/
+[p3]: http://www.parser.ru/
+[vp]: http://vasily.polovnyov.ru/
+[vd]: http://dolzhenko.blogspot.com/
+
+
+## Version 5.2
+
+- at last it's possible to replace indentation TABs with something sensible
+ (e.g. 2 or 4 spaces)
+- new keywords and built-ins for 1C by Sergey Baranov
+- a couple of small fixes to Apache highlighting
+
+
+## Version 5.1
+
+This is one of those nice version consisting entirely of new and shiny
+contributions!
+
+- [Vladimir Ermakov][vooon] created highlighting for AVR Assembler
+- [Ruslan Keba][rukeba] created highlighting for Apache config file. Also his
+ original visual style for it is now available for all highlight.js languages
+ under the name "Magula".
+- [Shuen-Huei Guan][drake] (aka Drake) sent new keywords for RenderMan
+ languages. Also thanks go to [Konstantin Evdokimenko][ke] for his advice on
+ the matter.
+
+[vooon]: http://vehq.ru/about/
+[rukeba]: http://rukeba.com/
+[drake]: http://drakeguan.org/
+[ke]: http://k-evdokimenko.moikrug.ru/
+
+
+## Version 5.0
+
+The main change in the new major version of highlight.js is a mechanism for
+packing several languages along with the library itself into a single compressed
+file. Now sites using several languages will load considerably faster because
+the library won't dynamically include additional files while loading.
+
+Also this version fixes a long-standing bug with Javascript highlighting that
+couldn't distinguish between regular expressions and division operations.
+
+And as usually there were a couple of minor correctness fixes.
+
+Great thanks to all contributors! Keep using highlight.js.
+
+
+## Version 4.3
+
+This version comes with two contributions from [Jason Diamond][jd]:
+
+- language definition for C# (yes! it was a long-missed thing!)
+- Visual Studio-like highlighting style
+
+Plus there are a couple of minor bug fixes for parsing HTML and XML attributes.
+
+[jd]: http://jason.diamond.name/weblog/
+
+
+## Version 4.2
+
+The biggest news is highlighting for Lisp, courtesy of Vasily Polovnyov. It's
+somewhat experimental meaning that for highlighting "keywords" it doesn't use
+any pre-defined set of a Lisp dialect. Instead it tries to highlight first word
+in parentheses wherever it makes sense. I'd like to ask people programming in
+Lisp to confirm if it's a good idea and send feedback to [the forum][f].
+
+Other changes:
+
+- Smalltalk was excluded from DEFAULT_LANGUAGES to save traffic
+- [Vladimir Epifanov][voldmar] has implemented javascript style switcher for
+ test.html
+- comments now allowed inside Ruby function definition
+- [MEL][] language from [Shuen-Huei Guan][drake]
+- whitespace now allowed between `
` and ``
+- better auto-detection of C++ and PHP
+- HTML allows embedded VBScript (`<% .. %>`)
+
+[f]: http://softwaremaniacs.org/forum/highlightjs/
+[voldmar]: http://voldmar.ya.ru/
+[mel]: http://en.wikipedia.org/wiki/Maya_Embedded_Language
+[drake]: http://drakeguan.org/
+
+
+## Version 4.1
+
+Languages:
+
+- Bash from Vah
+- DOS bat-files from Alexander Makarov (Sam)
+- Diff files from Vasily Polovnyov
+- Ini files from myself though initial idea was from Sam
+
+Styles:
+
+- Zenburn from Vladimir Epifanov, this is an imitation of a
+ [well-known theme for Vim][zenburn].
+- Ascetic from myself, as a realization of ideals of non-flashy highlighting:
+ just one color in only three gradations :-)
+
+In other news. [One small bug][bug] was fixed, built-in keywords were added for
+Python and C++ which improved auto-detection for the latter (it was shame that
+[my wife's blog][alenacpp] had issues with it from time to time). And lastly
+thanks go to Sam for getting rid of my stylistic comments in code that were
+getting in the way of [JSMin][].
+
+[zenburn]: http://en.wikipedia.org/wiki/Zenburn
+[alenacpp]: http://alenacpp.blogspot.com/
+[bug]: http://softwaremaniacs.org/forum/viewtopic.php?id=1823
+[jsmin]: http://code.google.com/p/jsmin-php/
+
+
+## Version 4.0
+
+New major version is a result of vast refactoring and of many contributions.
+
+Visible new features:
+
+- Highlighting of embedded languages. Currently is implemented highlighting of
+ Javascript and CSS inside HTML.
+- Bundled 5 ready-made style themes!
+
+Invisible new features:
+
+- Highlight.js no longer pollutes global namespace. Only one object and one
+ function for backward compatibility.
+- Performance is further increased by about 15%.
+
+Changing of a major version number caused by a new format of language definition
+files. If you use some third-party language files they should be updated.
+
+
+## Version 3.5
+
+A very nice version in my opinion fixing a number of small bugs and slightly
+increased speed in a couple of corner cases. Thanks to everybody who reports
+bugs in he [forum][f] and by email!
+
+There is also a new language — XML. A custom XML formerly was detected as HTML
+and didn't highlight custom tags. In this version I tried to make custom XML to
+be detected and highlighted by its own rules. Which by the way include such
+things as CDATA sections and processing instructions (``).
+
+[f]: http://softwaremaniacs.org/forum/viewforum.php?id=6
+
+
+## Version 3.3
+
+[Vladimir Gubarkov][xonix] has provided an interesting and useful addition.
+File export.html contains a little program that shows and allows to copy and
+paste an HTML code generated by the highlighter for any code snippet. This can
+be useful in situations when one can't use the script itself on a site.
+
+
+[xonix]: http://xonixx.blogspot.com/
+
+
+## Version 3.2 consists completely of contributions:
+
+- Vladimir Gubarkov has described SmallTalk
+- Yuri Ivanov has described 1C
+- Peter Leonov has packaged the highlighter as a Firefox extension
+- Vladimir Ermakov has compiled a mod for phpBB
+
+Many thanks to you all!
+
+
+## Version 3.1
+
+Three new languages are available: Django templates, SQL and Axapta. The latter
+two are sent by [Dmitri Roudakov][1]. However I've almost entirely rewrote an
+SQL definition but I'd never started it be it from the ground up :-)
+
+The engine itself has got a long awaited feature of grouping keywords
+("keyword", "built-in function", "literal"). No more hacks!
+
+[1]: http://roudakov.ru/
+
+
+## Version 3.0
+
+It is major mainly because now highlight.js has grown large and has become
+modular. Now when you pass it a list of languages to highlight it will
+dynamically load into a browser only those languages.
+
+Also:
+
+- Konstantin Evdokimenko of [RibKit][] project has created a highlighting for
+ RenderMan Shading Language and RenderMan Interface Bytestream. Yay for more
+ languages!
+- Heuristics for C++ and HTML got better.
+- I've implemented (at last) a correct handling of backslash escapes in C-like
+ languages.
+
+There is also a small backwards incompatible change in the new version. The
+function initHighlighting that was used to initialize highlighting instead of
+initHighlightingOnLoad a long time ago no longer works. If you by chance still
+use it — replace it with the new one.
+
+[RibKit]: http://ribkit.sourceforge.net/
+
+
+## Version 2.9
+
+Highlight.js is a parser, not just a couple of regular expressions. That said
+I'm glad to announce that in the new version 2.9 has support for:
+
+- in-string substitutions for Ruby -- `#{...}`
+- strings from from numeric symbol codes (like #XX) for Delphi
+
+
+## Version 2.8
+
+A maintenance release with more tuned heuristics. Fully backwards compatible.
+
+
+## Version 2.7
+
+- Nikita Ledyaev presents highlighting for VBScript, yay!
+- A couple of bugs with escaping in strings were fixed thanks to Mickle
+- Ongoing tuning of heuristics
+
+Fixed bugs were rather unpleasant so I encourage everyone to upgrade!
+
+
+## Version 2.4
+
+- Peter Leonov provides another improved highlighting for Perl
+- Javascript gets a new kind of keywords — "literals". These are the words
+ "true", "false" and "null"
+
+Also highlight.js homepage now lists sites that use the library. Feel free to
+add your site by [dropping me a message][mail] until I find the time to build a
+submit form.
+
+[mail]: mailto:Maniac@SoftwareManiacs.Org
+
+
+## Version 2.3
+
+This version fixes IE breakage in previous version. My apologies to all who have
+already downloaded that one!
+
+
+## Version 2.2
+
+- added highlighting for Javascript
+- at last fixed parsing of Delphi's escaped apostrophes in strings
+- in Ruby fixed highlighting of keywords 'def' and 'class', same for 'sub' in
+ Perl
+
+
+## Version 2.0
+
+- Ruby support by [Anton Kovalyov][ak]
+- speed increased by orders of magnitude due to new way of parsing
+- this same way allows now correct highlighting of keywords in some tricky
+ places (like keyword "End" at the end of Delphi classes)
+
+[ak]: http://anton.kovalyov.net/
+
+
+## Version 1.0
+
+Version 1.0 of javascript syntax highlighter is released!
+
+It's the first version available with English description. Feel free to post
+your comments and question to [highlight.js forum][forum]. And don't be afraid
+if you find there some fancy Cyrillic letters -- it's for Russian users too :-)
+
+[forum]: http://softwaremaniacs.org/forum/viewforum.php?id=6
diff --git a/lib/3rdparty/highlight/LICENSE b/lib/3rdparty/highlight/LICENSE
new file mode 100644
index 0000000..422deb7
--- /dev/null
+++ b/lib/3rdparty/highlight/LICENSE
@@ -0,0 +1,24 @@
+Copyright (c) 2006, Ivan Sagalaev
+All rights reserved.
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+ * Neither the name of highlight.js nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/lib/3rdparty/highlight/README.md b/lib/3rdparty/highlight/README.md
new file mode 100644
index 0000000..9f76e6b
--- /dev/null
+++ b/lib/3rdparty/highlight/README.md
@@ -0,0 +1,150 @@
+# Highlight.js
+
+[](https://travis-ci.org/isagalaev/highlight.js)
+
+Highlight.js is a syntax highlighter written in JavaScript. It works in
+the browser as well as on the server. It works with pretty much any
+markup, doesn’t depend on any framework and has automatic language
+detection.
+
+## Getting Started
+
+The bare minimum for using highlight.js on a web page is linking to the
+library along with one of the styles and calling
+[`initHighlightingOnLoad`][1]:
+
+```html
+
+
+
+```
+
+This will find and highlight code inside of `
` tags; it tries
+to detect the language automatically. If automatic detection doesn’t
+work for you, you can specify the language in the `class` attribute:
+
+```html
+
...
+```
+
+The list of supported language classes is available in the [class
+reference][2]. Classes can also be prefixed with either `language-` or
+`lang-`.
+
+To disable highlighting altogether use the `nohighlight` class:
+
+```html
+
...
+```
+
+## Custom Initialization
+
+When you need a bit more control over the initialization of
+highlight.js, you can use the [`highlightBlock`][3] and [`configure`][4]
+functions. This allows you to control *what* to highlight and *when*.
+
+Here’s an equivalent way to calling [`initHighlightingOnLoad`][1] using
+jQuery:
+
+```javascript
+$(document).ready(function() {
+ $('pre code').each(function(i, block) {
+ hljs.highlightBlock(block);
+ });
+});
+```
+
+You can use any tags instead of `
` to mark up your code. If
+you don't use a container that preserve line breaks you will need to
+configure highlight.js to use the ` ` tag:
+
+```javascript
+hljs.configure({useBR: true});
+
+$('div.code').each(function(i, block) {
+ hljs.highlightBlock(block);
+});
+```
+
+For other options refer to the documentation for [`configure`][4].
+
+
+## Web Workers
+
+You can run highlighting inside a web worker to avoid freezing the browser
+window while dealing with very big chunks of code.
+
+In your main script:
+
+```javascript
+addEventListener('load', function() {
+ var code = document.querySelector('#code');
+ var worker = new Worker('worker.js');
+ worker.onmessage = function(event) { code.innerHTML = event.data; }
+ worker.postMessage(code.textContent);
+})
+```
+
+In worker.js:
+
+```javascript
+onmessage = function(event) {
+ importScripts('/highlight.pack.js');
+ var result = self.hljs.highlightAuto(event.data);
+ postMessage(result.value);
+}
+```
+
+
+## Getting the Library
+
+You can get highlight.js as a hosted, or custom-build, browser script or
+as a server module. Right out of the box the browser script supports
+both AMD and CommonJS, so if you wish you can use RequireJS or
+Browserify without having to build from source. The server module also
+works perfectly fine with Browserify, but there is the option to use a
+build specific to browsers rather than something meant for a server.
+Head over to the [download page][5] for all the options.
+
+**Don't link to GitHub directly.** The library is not supposed to work straight
+from the source, it requires building. If none of the pre-packaged options
+work for you refer to the [building documentation][6].
+
+**The CDN-hosted package doesn't have all the languages.** Otherwise it'd be
+too big. If you don't see the language you need in the ["Common" section][5],
+it can be added manually:
+
+```html
+
+```
+
+**On Almond.** You need to use the optimizer to give the module a name. For
+example:
+
+```
+r.js -o name=hljs paths.hljs=/path/to/highlight out=highlight.js
+```
+
+
+## License
+
+Highlight.js is released under the BSD License. See [LICENSE][7] file
+for details.
+
+## Links
+
+The official site for the library is at .
+
+Further in-depth documentation for the API and other topics is at
+.
+
+Authors and contributors are listed in the [AUTHORS.en.txt][8] file.
+
+[1]: http://highlightjs.readthedocs.io/en/latest/api.html#inithighlightingonload
+[2]: http://highlightjs.readthedocs.io/en/latest/css-classes-reference.html
+[3]: http://highlightjs.readthedocs.io/en/latest/api.html#highlightblock-block
+[4]: http://highlightjs.readthedocs.io/en/latest/api.html#configure-options
+[5]: https://highlightjs.org/download/
+[6]: http://highlightjs.readthedocs.io/en/latest/building-testing.html
+[7]: https://github.com/isagalaev/highlight.js/blob/master/LICENSE
+[8]: https://github.com/isagalaev/highlight.js/blob/master/AUTHORS.en.txt
diff --git a/lib/3rdparty/highlight/README.ru.md b/lib/3rdparty/highlight/README.ru.md
new file mode 100644
index 0000000..ac481d0
--- /dev/null
+++ b/lib/3rdparty/highlight/README.ru.md
@@ -0,0 +1,142 @@
+# Highlight.js
+
+Highlight.js — это инструмент для подсветки синтаксиса, написанный на JavaScript. Он работает
+и в браузере, и на сервере. Он работает с практически любой HTML разметкой, не
+зависит от каких-либо фреймворков и умеет автоматически определять язык.
+
+
+## Начало работы
+
+Минимум, что нужно сделать для использования highlight.js на веб-странице — это
+подключить библиотеку, CSS-стили и вызывать [`initHighlightingOnLoad`][1]:
+
+```html
+
+
+
+```
+
+Библиотека найдёт и раскрасит код внутри тегов `
`, попытавшись
+автоматически определить язык. Когда автоопределение не срабатывает, можно явно
+указать язык в атрибуте class:
+
+```html
+
...
+```
+
+Список поддерживаемых классов языков доступен в [справочнике по классам][2].
+Класс также можно предварить префиксами `language-` или `lang-`.
+
+Чтобы отключить подсветку для какого-то блока, используйте класс `nohighlight`:
+
+```html
+
...
+```
+
+## Инициализация вручную
+
+Чтобы иметь чуть больше контроля за инициализацией подсветки, вы можете
+использовать функции [`highlightBlock`][3] и [`configure`][4]. Таким образом
+можно управлять тем, *что* и *когда* подсвечивать.
+
+Вот пример инициализации, эквивалентной вызову [`initHighlightingOnLoad`][1], но
+с использованием jQuery:
+
+```javascript
+$(document).ready(function() {
+ $('pre code').each(function(i, block) {
+ hljs.highlightBlock(block);
+ });
+});
+```
+
+Вы можете использовать любые теги разметки вместо `