book-source 0.3.10 → 0.3.13

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Cédric Ronvel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/StructuredDocument.js

@@ -30,7 +30,6 @@
 
 const documentParts = require( './documentParts.js' ) ;
 const Style = require( './Style.js' ) ;
-const Theme = require( './Theme.js' ) ;
 const textPostFilters = require( './textPostFilters.js' ) ;
 
 const inPlaceFilter = require( 'array-kit/lib/inPlaceFilter.js' ) ;
@@ -38,24 +37,41 @@ const inPlaceFilter = require( 'array-kit/lib/inPlaceFilter.js' ) ;
 
 
 function StructuredDocument() {
+	this.type = 'document' ;
 	this.title = 'Document' ;
 	this.metadata = null ;
 	this.theme = null ;
+	this.summary = null ;
 	this.parts = [] ;
+	//this.idList = new Set() ;
 }
 
 module.exports = StructuredDocument ;
 
+// Circular require, should come after exporting
+const postProcesses = require( './postProcesses.js' ) ;
 
 
-StructuredDocument.prototype.render = function( renderer ) {
-	var meta = {
-		title: this.title
-	} ;
 
-	var output = this.renderParts( renderer , this.parts , [] , [ {} ] ) ;
+StructuredDocument.prototype.render = function( renderer , special = null ) {
+	let toRender ;
+
+	switch ( special ) {
+		case 'summary' :
+			toRender = this.summary ? [ this.summary ] : [] ;
+			break ;
+		default :
+			toRender = this.parts ;
+			break ;
+	}
+
+	let output = this.renderParts( renderer , toRender , [] , [ {} ] ) ;
 
 	if ( renderer.document ) {
+		let meta = {
+			title: this.title
+		} ;
+
 		output = renderer.document( meta , output ) ;
 	}
 
@@ -199,25 +215,79 @@ StructuredDocument.prototype.autoTitle = function() {
 
 	if ( ! header ) { return ; }
 
-	str = StructuredDocument.getText( header.parts ) ;
+	str = StructuredDocument.getText( header ) ;
 	if ( str ) { this.title = str ; }
 } ;
 
 
 
-StructuredDocument.getText = function( parts ) {
-	var str = '' ;
+StructuredDocument.prototype.postProcess = function( params = {} ) {
+	var data = {} ,
+		postProcessArray = [] ,
+		postProcessMap = new Map() ;
 
-	for ( let part of parts ) {
-		if ( part.text ) { str += part.text ; }
-		else if ( part.parts?.length ) { str += StructuredDocument.getText( part.parts ) ; }
+	for ( let postProcessName of Object.keys( params ) ) {
+		if ( ! postProcesses[ postProcessName ] || ! params[ postProcessName ] ) { continue ; }
+
+		let postProcess = postProcesses[ postProcessName ] ;
+
+		// Add required post-process first
+		if ( postProcess.require ) {
+			for ( let requiredName of postProcess.require ) {
+				if ( ! postProcessMap.has( requiredName ) ) {
+					let entry = { name: requiredName , params: {} } ;
+					postProcessArray.push( entry ) ;
+					postProcessMap.set( requiredName , entry ) ;
+				}
+			}
+		}
+
+		if ( postProcessMap.has( postProcessName ) ) {
+			// It was already added by a dependency, just patch the params if needed
+			if ( typeof params[ postProcessName ] === 'object' ) {
+				let entry = postProcessMap.get( postProcessName ) ;
+				entry.params = Object.assign( {} , params[ postProcessName ] ) ;
+			}
+		}
+		else {
+			let entry = {
+				name: postProcessName ,
+				params: typeof params[ postProcessName ] === 'object' ? Object.assign( {} , params[ postProcessName ] ) : {}
+			} ;
+
+			postProcessArray.push( entry ) ;
+			postProcessMap.set( postProcessName , entry ) ;
+		}
 	}
 
-	return str ;
+	for ( let entry of postProcessArray ) {
+		if ( postProcesses[ entry.name ].init ) {
+			postProcesses[ entry.name ].init( this , entry.params , data ) ;
+		}
+	}
+
+	this.postProcessRecursive( this , postProcessArray , data ) ;
+
+	for ( let entry of postProcessArray ) {
+		if ( postProcesses[ entry.name ].finalize ) {
+			postProcesses[ entry.name ].finalize( this , entry.params , data ) ;
+		}
+	}
 } ;
 
-// Backqard compatibility/API
-StructuredDocument.prototype.getText = function( parts = this.parts ) { return StructuredDocument.getText( parts ) ; } ;
+
+
+StructuredDocument.prototype.postProcessRecursive = function( object , postProcessArray , data ) {
+	for ( let entry of postProcessArray ) {
+		postProcesses[ entry.name ]( this , object , entry.params , data ) ;
+	}
+
+	if ( object.parts && object.parts.length ) {
+		for ( let part of object.parts ) {
+			this.postProcessRecursive( part , postProcessArray , data ) ;
+		}
+	}
+} ;
 
 
 
@@ -251,10 +321,49 @@ StructuredDocument.prototype.oneTextPostFilter = function( postFilter , parts ,
 
 
 
+// Utility methods
+
+
+
+StructuredDocument.getText = function( object ) {
+	if ( Array.isArray( object ) ) {
+		object = { parts: object } ;
+	}
+
+	if ( object.text ) { return object.text ; }
+	if ( ! object.parts || ! object.parts.length ) { return '' ; }
+
+	let str = '' ;
+
+	for ( let part of object.parts ) {
+		str += StructuredDocument.getText( part ) ;
+	}
+
+	return str ;
+} ;
+
+// Backward compatibility/API
+StructuredDocument.prototype.getText = function( object = this ) { return StructuredDocument.getText( object ) ; } ;
+
+
+
+StructuredDocument.textToId = function( text ) {
+	return text
+		.trim()
+		.normalize( 'NFC' )
+		.replace( /[\s]+/g , '_' )
+		.replace( /[^\p{L}\p{N}_.:-]/gu , '' )
+		.replace( /_+/g , '_' ) ;
+} ;
+
+
+
 // Parser
 
-StructuredDocument.parse = function( str , options ) {
-	if ( ! options || typeof options !== 'object' ) { options = {} ; }
+
+
+StructuredDocument.parse = function( str , params ) {
+	if ( ! params || typeof params !== 'object' ) { params = {} ; }
 
 	if ( typeof str !== 'string' ) {
 		if ( str && typeof str === 'object' ) { str = str.toString() ; }
@@ -281,10 +390,11 @@ StructuredDocument.parse = function( str , options ) {
 	parseBlocks( str , ctx ) ;
 
 	for ( let table of ctx.rowSpanTables ) { postProcessTableRowSpan( table ) ; }
+
 	ctx.structuredDocument.autoTitle() ;
 
 	if ( ctx.rawMetadata ) {
-		let metadataParser = options.metadataParser || JSON.parse ;
+		let metadataParser = params.metadataParser || JSON.parse ;
 		for ( let type in ctx.rawMetadata ) {
 			try {
 				let parsed = metadataParser( ctx.rawMetadata[ type ] ) ;
@@ -299,10 +409,6 @@ StructuredDocument.parse = function( str , options ) {
 		}
 	}
 
-	// Call depthManagement() one last time, because some instanceOf may still be hanging...
-	//ctx.depth = -1 ;
-	//depthManagement( ctx ) ;
-
 	return ctx.structuredDocument ;
 } ;
 
@@ -391,6 +497,9 @@ function parseBlock( str , ctx ) {
 		case BLOCK_METADATA :
 			parseMetadata( str , ctx ) ;
 			break ;
+		case BLOCK_SPECIAL :
+			parseSpecial( str , ctx ) ;
+			break ;
 		default :
 			throw new Error( "Bad block detection: " + blockType ) ;
 	}
@@ -499,6 +608,7 @@ const BLOCK_TABLE_ROW_THICK_SEPARATOR = 42 ;
 const BLOCK_TABLE_CAPTION = 43 ;
 const BLOCK_ANCHOR = 50 ;
 const BLOCK_METADATA = 60 ;
+const BLOCK_SPECIAL = 80 ;
 
 function detectBlockType( str , i ) {
 	if ( str[ i ] === '\\' ) {
@@ -506,14 +616,17 @@ function detectBlockType( str , i ) {
 	}
 
 	if ( str[ i ] === '#' ) {
-		if ( str[ i + 1 ] === '(' ) { return BLOCK_ANCHOR ; }
+		if ( str[ i + 1 ] === '(' ) {
+			if ( str[ i + 2 ] === '%' ) { return BLOCK_SPECIAL ; }
+			return BLOCK_ANCHOR ;
+		}
 		return BLOCK_HEADER ;
 	}
 
 	if ( str[ i ] === '!' && str[ i + 2 ] === '[' ) {
 		if ( str[ i + 1 ] === '=' ) { return BLOCK_MEDIA ; }
-		else if ( str[ i + 1 ] === '<' ) { return BLOCK_FLOAT_LEFT_MEDIA ; }
-		else if ( str[ i + 1 ] === '>' ) { return BLOCK_FLOAT_RIGHT_MEDIA ; }
+		if ( str[ i + 1 ] === '<' ) { return BLOCK_FLOAT_LEFT_MEDIA ; }
+		if ( str[ i + 1 ] === '>' ) { return BLOCK_FLOAT_RIGHT_MEDIA ; }
 		return BLOCK_PARAGRAPH ;
 	}
 
@@ -864,6 +977,18 @@ function parseAnchor( str , ctx ) {
 
 
 
+function parseSpecial( str , ctx ) {
+	//console.log( "parseSpecial()" ) ;
+	var end = searchCloser( str , ctx.i + 3 , '(' , ')' , true ) ;
+	if ( end < 0 ) { return parseParagraph( str , ctx ) ; }
+
+	ctx.parts.push( new documentParts.Special( str.slice( ctx.i + 3 , end ) ) ) ;
+
+	ctx.i = end + 1 ;
+}
+
+
+
 function parseTableCaption( str , ctx ) {
 	//console.log( "parseTableCaption()" ) ;
 	var lastCharOfLine = searchLastCharOfLine( str , ctx.i + 1 ) ;
@@ -901,7 +1026,7 @@ function parseTableCaption( str , ctx ) {
 		if ( data?.style?.[ 0 ] ) { tableCaption.style = data.style[ 0 ] ; }
 	}
 
-	ctx.i = lastCharOfLine + 1 ;
+	ctx.i = searchEndOfLine( str , lastCharOfLine !== - 1 ? lastCharOfLine : ctx.i ) + 1 ;
 }
 
 
@@ -991,7 +1116,7 @@ function parseTableRow( str , ctx ) {
 		currentBar = columnSeparator ? nextBar + 1 : nextBar ;
 	}
 
-	// Compute cells indexes, columnSpan, rowSpan, column template
+	// Compute cells indexes, columnSpan, column template, and add missing cells
 	computeIndexColumnSpan( ctx , table , tableRow ) ;
 
 	if ( str[ currentBar + 1 ] === '<' ) {
@@ -1000,7 +1125,7 @@ function parseTableRow( str , ctx ) {
 		if ( data?.style?.[ 0 ] ) { tableRow.style = data.style[ 0 ] ; }
 	}
 
-	ctx.i = lastCharOfLine + 1 ;
+	ctx.i = searchEndOfLine( str , lastCharOfLine !== - 1 ? lastCharOfLine : ctx.i ) + 1 ;
 }
 
 
@@ -1033,7 +1158,7 @@ function parseTableMultilineRow( str , ctx , lastCharOfLine , table , tableRow )
 		columnIndex ++ ;
 	}
 
-	ctx.i = lastCharOfLine + 1 ;
+	ctx.i = searchEndOfLine( str , lastCharOfLine !== - 1 ? lastCharOfLine : ctx.i ) + 1 ;
 }
 
 
@@ -1143,7 +1268,7 @@ function parseTableRowSeparator( str , ctx , thick = false ) {
 		separatorCellIndex ++ ;
 	}
 
-	ctx.i = lastCharOfLine + 1 ;
+	ctx.i = searchEndOfLine( str , lastCharOfLine !== - 1 ? lastCharOfLine : ctx.i ) + 1 ;
 }
 
 
@@ -1291,15 +1416,16 @@ function parseTableHeadRowSeparator( str , ctx , thick , lastCharOfLine ) {
 	}
 
 	if ( tableHeadRow ) {
-		// Compute cells indexes, columnSpan, rowSpan, column template
+		// Compute cells indexes, columnSpan, column template, and add missing cells
 		computeIndexColumnSpan( ctx , table , tableHeadRow ) ;
 	}
 
-	ctx.i = lastCharOfLine + 1 ;
+	ctx.i = searchEndOfLine( str , lastCharOfLine !== - 1 ? lastCharOfLine : ctx.i ) + 1 ;
 }
 
 
 
+// Compute cells indexes, columnSpan, column template, and add missing cells
 function computeIndexColumnSpan( ctx , table , tableRow ) {
 	var tableCell , cellIndex , column , columnIndex , columnSpan ,
 		columns = table.columns ,
@@ -1336,6 +1462,19 @@ function computeIndexColumnSpan( ctx , table , tableRow ) {
 			}
 		}
 	}
+
+	// Add missing cells
+	if ( columns ) {
+		for ( ; extraSpan > 0 ; extraSpan -- ) {
+			columnIndex = table.columns.length - extraSpan ;
+			column = table.columns[ columnIndex ] ;
+			tableCell = new documentParts.TableCell() ;
+			tableCell.column = columnIndex ;
+			tableCell.sx = column?.sx || - 1 ;
+			tableCell.ex = column?.ex || - 1 ;
+			tableRow.parts.push( tableCell ) ;
+		}
+	}
 }
 
 
@@ -1359,9 +1498,7 @@ function parseInlineChildrenOfParent( str , ctx , parent , blockEnd , trim = fal
 // Try to parse non-block content
 function parseInline( str , ctx , blockEnd , trim = false ) {
 	//console.log( "parseInline() -- remaining:" , ctx.i , str.slice( ctx.i ) ) ;
-	var isSpace , scanEnd ;
-
-	scanEnd = blockEnd = blockEnd ?? searchEndOfLine( str , ctx.i ) ;
+	var scanEnd = blockEnd = blockEnd ?? searchEndOfLine( str , ctx.i ) ;
 
 	if ( trim ) {
 		let first = searchNextNotInSet( str , ctx.i , blockEnd , WHITE_SPACES ) ;
@@ -1647,7 +1784,7 @@ function parseInfotipedText( str , ctx , scanEnd ) {
 	ctx.iStartOfInlineChunk = ctx.i + 1 ;
 
 	if ( ! href && ! hint ) {
-		infotipedText.href = StructuredDocument.getText( infotipedText.parts ) ;
+		infotipedText.href = StructuredDocument.getText( infotipedText ) ;
 	}
 }
 
@@ -2001,7 +2138,7 @@ function searchBlockSwitchCloser( str , i , closer , closerMinStreak = 1 , end =
 	Same that searchBlockSwitchCloser() but with a callback function.
 */
 function searchFixedBlockSwitchCloser( str , i , fixed , end = str.length ) {
-	var test , j , failed ;
+	var j , failed ;
 
 	while ( i < end ) {
 		// Search next line

package/lib/documentParts.js

@@ -33,13 +33,17 @@ module.exports = documentParts ;
 
 
 
-function Part() {}
+function Part() {
+	this.id = null ;
+}
 
 documentParts.Part = Part ;
 
 
 
-function InlinePart() {}
+function InlinePart() {
+	Part.call( this ) ;
+}
 
 InlinePart.prototype = Object.create( Part.prototype ) ;
 InlinePart.prototype.constructor = InlinePart ;
@@ -48,6 +52,7 @@ documentParts.InlinePart = InlinePart ;
 
 
 function InlineContainerPart() {
+	Part.call( this ) ;
 	this.parts = [] ;
 }
 
@@ -58,6 +63,7 @@ documentParts.InlineContainerPart = InlineContainerPart ;
 
 
 function InlineTextPart( text ) {
+	Part.call( this ) ;
 	this.text = text ;
 }
 
@@ -67,7 +73,9 @@ documentParts.InlineTextPart = InlineTextPart ;
 
 
 
-function BlockPart() {}
+function BlockPart() {
+	Part.call( this ) ;
+}
 
 BlockPart.prototype = Object.create( Part.prototype ) ;
 BlockPart.prototype.constructor = BlockPart ;
@@ -76,6 +84,7 @@ documentParts.BlockPart = BlockPart ;
 
 
 function BlockContainerPart() {
+	Part.call( this ) ;
 	this.parts = [] ;
 }
 
@@ -362,6 +371,18 @@ documentParts.Anchor = Anchor ;
 
 
 
+function Special( special ) {
+	this.type = 'special' ;
+	this.special = special ;
+	BlockContainerPart.call( this ) ;
+}
+
+Special.prototype = Object.create( BlockContainerPart.prototype ) ;
+Special.prototype.constructor = Special ;
+documentParts.Special = Special ;
+
+
+
 function ImageBlock( href , altText , float , caption , hint ) {
 	this.type = 'imageBlock' ;
 	this.href = href ;

package/lib/postProcesses.js

@@ -0,0 +1,150 @@
+/*
+	Book Source
+
+	Copyright (c) 2023 Cédric Ronvel
+
+	The MIT License (MIT)
+
+	Permission is hereby granted, free of charge, to any person obtaining a copy
+	of this software and associated documentation files (the "Software"), to deal
+	in the Software without restriction, including without limitation the rights
+	to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+	copies of the Software, and to permit persons to whom the Software is
+	furnished to do so, subject to the following conditions:
+
+	The above copyright notice and this permission notice shall be included in all
+	copies or substantial portions of the Software.
+
+	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+	IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+	FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+	AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+	LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+	OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+	SOFTWARE.
+*/
+
+"use strict" ;
+
+
+
+const StructuredDocument = require( './StructuredDocument.js' ) ;
+const documentParts = require( './documentParts.js' ) ;
+
+
+
+exports.autoId = ( structuredDocument , object , params , data ) => {
+	if ( ! params.types.has( object.type ) ) { return ; }
+
+	let text = StructuredDocument.getText( object ) ;
+	let id = data.idPrefix + StructuredDocument.textToId( text ) ;
+
+	if ( data.idList.has( id ) ) {
+		let originalId = id ;
+		let count = data.idList.get( originalId ) ;
+		count ++ ;
+		id = originalId + '_' + count ;
+
+		while ( data.idList.has( id ) ) {
+			count ++ ;
+			id = originalId + '_' + count ;
+		}
+
+		data.idList.set( originalId , count ) ;
+	}
+
+	// Always add the current ID, even if originalId was added too
+	data.idList.set( id , 1 ) ;
+
+	object.id = id ;
+} ;
+
+const DEFAULT_AUTO_ID_TYPES = new Set( [ 'header' ] ) ;
+
+exports.autoId.init = ( structuredDocument , params , data ) => {
+	if ( Array.isArray( params.types ) ) { params.types = new Set( params.types ) ; }
+	else if ( ! params.types || ! ( params.types instanceof Set ) ) { params.types = DEFAULT_AUTO_ID_TYPES ; }
+
+	if ( data.idPrefix === undefined ) { data.idPrefix = params.idPrefix || '' ; }
+
+	data.idList = new Map() ;
+} ;
+
+
+
+exports.summary = ( structuredDocument , object , params , data ) => {
+	if ( object.type === 'special' ) {
+		switch ( object.special ) {
+			case 'summary' :
+				data.summaryObjects.push( object ) ;
+				break ;
+			case 'summary-start' :
+				resetSummary( data ) ;
+				break ;
+			case 'summary-end' :
+				data.summaryEnded = true ;
+				break ;
+		}
+
+		return ;
+	}
+
+	if ( data.summaryEnded || object.type !== 'header' || object.level > params.maxLevel ) { return ; }
+
+	let item = new documentParts.ListItem( object.level - 1 ) ;
+	let link = new documentParts.Link( '#' + object.id ) ;
+	item.parts.push( link ) ;
+	let text = new documentParts.Text( StructuredDocument.getText( object ) ) ;
+	link.parts.push( text ) ;
+
+	if ( ! data.summaryHeaderLevelStack.length ) {
+		data.summaryHeaderLevelStack.push( object.level ) ;
+	}
+
+	let lastListLevel = data.summaryHeaderLevelStack.length - 1 ;
+	let lastHeaderLevel = data.summaryHeaderLevelStack[ lastListLevel ] ;
+
+	while ( object.level < lastHeaderLevel && lastListLevel > 0 ) {
+		lastListLevel -- ;
+		lastHeaderLevel = data.summaryHeaderLevelStack[ lastListLevel ] ;
+		data.summaryHeaderLevelStack.length = data.summaryListStack.length = lastListLevel + 1 ;
+	}
+
+	if ( object.level > lastHeaderLevel ) {
+		let parentList = data.summaryListStack[ lastListLevel ] ;
+		let currentList = new documentParts.List( object.level - 1 ) ;
+		data.summaryListStack.push( currentList ) ;
+		data.summaryHeaderLevelStack.push( object.level ) ;
+		currentList.parts.push( item ) ;
+		parentList.parts.push( currentList ) ;
+	}
+	else {
+		// It's equal OR the doc is not well-formed and it's less, nevertheless, we just act as if it's equal
+		let currentList = data.summaryListStack[ lastListLevel ] ;
+		currentList.parts.push( item ) ;
+	}
+} ;
+
+exports.summary.init = ( structuredDocument , params , data ) => {
+	params.maxLevel = params.maxLevel || Infinity ;
+	data.summaryObjects = [] ;
+	resetSummary( data ) ;
+} ;
+
+function resetSummary( data ) {
+	data.summaryList = new documentParts.List( 0 ) ;
+	data.summaryListStack = [ data.summaryList ] ;
+	data.summaryHeaderLevelStack = [] ;
+	data.summaryEnded = false ;
+}
+
+exports.summary.finalize = ( structuredDocument , params , data ) => {
+	structuredDocument.summary = data.summaryList ;
+
+	for ( let summaryObject of data.summaryObjects ) {
+		summaryObject.parts.push( data.summaryList ) ;
+	}
+} ;
+
+exports.summary.require = [ 'autoId' ] ;
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "book-source",
-  "version": "0.3.10",
+  "version": "0.3.13",
   "description": "A lightweight markup language, inspired by Markdown.",
   "main": "lib/book-source.js",
   "directories": {

package/.eslintrc.js

@@ -1,168 +0,0 @@
-module.exports = {
-	'root': true ,
-	'env': {
-		'browser': true ,
-		'node': true ,
-		'es6': true ,
-		'es2022': true
-	} ,
-	'parserOptions': {
-		'ecmaVersion': 2022
-	} ,
-	'extends': [ 'eslint:recommended' ] ,
-	'ignorePatterns': [ "*.min.js" ] ,
-	'rules': {
-		
-		/*
-			Bad code -- detect anything that can be broken or lead to bugs
-		*/
-		
-		
-		
-		'strict': [ 'error' , 'global' ] ,
-		'unicode-bom': [ 'error' , 'never' ] ,
-		'radix': 'error' ,
-		'eqeqeq': 'error' ,
-		'consistent-return': 'off' ,
-		'valid-typeof': 'error' ,
-		'no-unneeded-ternary': 'error' ,
-		'no-unused-vars': 'warn' ,	// During development phase, it's boring to clean unused var since they can be used later
-		'no-lonely-if': 'off' ,		// Can hurt semantic programming
-		'no-nested-ternary': 'off' ,	// Now I use the streamlined ternary operator a lot
-		'no-shadow': 'error' ,
-		'no-shadow-restricted-names': 'error' ,
-		'require-atomic-updates': 'off' ,	// check for possible race condition on assignment, interesting but too nitpicky
-		
-		
-		
-		/*
-			Code preferences
-		*/
-		
-		
-		
-		'prefer-arrow-callback': 'error' ,
-		'prefer-spread': 'warn' ,
-		'prefer-rest-params': 'warn' ,
-		'no-control-regex': 'off' ,	// because thing like \x00 are considered like a control even if escaped...
-		'no-fallthrough': 'off' ,
-		'no-empty': [ 'error' , {
-			'allowEmptyCatch': true
-		} ] ,
-		
-		
-		
-		/*
-			Coding styles -- cosmetic rules and opinionated preferences
-		*/
-		
-		
-		
-		// Indent & spaces (general)
-		'indent': [ 'error' , 'tab' , {
-			'SwitchCase': 1 ,
-			'MemberExpression': 1 ,
-			'flatTernaryExpressions': true
-		} ] ,
-		'newline-per-chained-call': 'off',
-		'no-multi-spaces': 'off' ,
-		'block-spacing': 'error' ,
-		'comma-spacing': [ 'error' , {
-			'before': true ,
-			'after': true
-		} ] ,
-		'no-whitespace-before-property': 'error' ,
-		'space-before-blocks': 'error' ,
-		'space-before-function-paren': [ 'error' , {
-			'anonymous': 'never',
-			'named': 'never',
-			'asyncArrow': 'always'
-		} ] ,
-		'space-infix-ops': 'error' ,
-		'space-unary-ops': [ 'error' , {
-			'words': true ,
-			'nonwords': true ,
-			'overrides': {
-				//'-': false ,
-			}
-		} ] ,
-		'space-in-parens': [ 'error' , 'always' , {
-			'exceptions': [ 'empty' ]
-		} ] ,
-		'no-trailing-spaces': 'error' ,
-		'switch-colon-spacing': [ 'error' , {
-			'after': true ,
-			'before': true
-		} ] ,
-		'arrow-spacing': 'error' ,
-		'rest-spread-spacing': [ 'error' , 'always' ] ,
-		/* Troublesome with commented line of code
-		'spaced-comment': [ 'error' , 'always' , {
-			'line': {
-				'markers': [ '/' ],
-				'exceptions': [ '-', '*', '/' ]
-			} ,
-			'block': {
-				'exceptions': [ '*' ] ,
-				'balanced': true
-			}
-		} ] ,
-		*/
-		
-		
-		// Semi-colon
-		'semi': [ 'error' , 'always' ] ,
-		'semi-style': [ 'error' , 'last' ] ,
-		'semi-spacing': [ 'error' , {
-			'before': true ,
-			'after': true
-		} ] ,
-
-		// Objects
-		'key-spacing': [ 'error' , {
-			'beforeColon': false ,
-			'afterColon': true ,
-			'mode': 'strict'
-		} ] ,
-		'object-curly-newline': [ 'error' , {
-			'ObjectExpression' : {
-				'consistent': true ,
-				'minProperties': 4
-			} ,
-			'ObjectPattern' : {
-				// object destructuring assigment
-				'consistent': true ,
-				'minProperties': 8
-			}
-		} ] ,
-		'object-curly-spacing': [ 'error' , 'always' ] ,
-		'object-property-newline': [ 'error' , { 'allowMultiplePropertiesPerLine': true } ] ,
-
-		
-		// Arrays
-		'array-bracket-newline': [ 'error' , 'consistent' ] ,
-		//'array-element-newline': [ 'error' , { 'multiline': true , 'minItems': 5 } ] ,
-		'array-bracket-spacing': [ 'error' , 'always' ],
-		
-		'brace-style': [ 'error' , 'stroustrup' , {
-			'allowSingleLine': true
-		} ] ,
-		
-		
-		// Misc style
-		'no-else-return': 'warn' ,
-		'comma-dangle': [ 'error' , 'never' ] ,
-		'quotes': 'off' ,
-		'camelcase': 'warn' ,
-		
-		
-		
-		/*
-			Method limitation
-		*/
-		
-		
-		
-		'no-console': 'off'
-	}
-} ;

package/Makefile

@@ -1,112 +0,0 @@
-
-
-
-# User rules
-
-# The first rule is the default rule, when invoking "make" without argument...
-# Build every buildable things
-#all: install doc browser
-all: install doc
-
-# Just install things so it works, basicaly: it just performs a "npm install --production" ATM
-install: log/npm-install.log
-
-# Just install things so it works, basicaly: it just performs a "npm install" ATM
-dev-install: log/npm-dev-install.log
-
-# Build
-#build: browser
-
-# Build the browser lib
-#browser: browser/svg-kit.js browser/svg-kit.min.js
-
-# This run the JsHint & Mocha BDD test, display it to STDOUT & save it to log/mocha.log and log/jshint.log
-test: log/jshint.log log/mocha.log
-
-# This run the JsHint, display it to STDOUT & save it to log/jshint.log
-lint: log/jshint.log
-
-# This run the Mocha BDD test, display it to STDOUT & save it to log/mocha.log
-unit: log/mocha.log
-
-# This build the doc and README.md
-doc: README.md
-
-# This publish to NPM and push to Github, if we are on master branch only
-publish: log/npm-publish.log log/github-push.log
-
-# Clean temporary things, or things that can be automatically regenerated
-clean: clean-all
-
-
-
-# Variables
-
-BROWSERIFY=browserify
-UGLIFY=uglifyjs
-
-
-
-# Files rules
-
-# Build the browser lib
-#browser/svg-kit.js: lib/*.js lib/*/*.js
-#	${BROWSERIFY} lib/svg-kit.js -i fs -i image-size -s svgKit -o browser/svg-kit.js
-
-# Build the browser minified lib
-#browser/svg-kit.min.js: browser/svg-kit.js
-#	${UGLIFY} browser/svg-kit.js -o browser/svg-kit.min.js -m
-
-# JsHint STDOUT test
-log/jshint.log: log/npm-dev-install.log lib/*.js test/*.js
-	${JSHINT} lib/*.js test/*.js | tee log/jshint.log ; exit $${PIPESTATUS[0]}
-
-# Mocha BDD STDOUT test
-log/mocha.log: log/npm-dev-install.log lib/*.js test/*.js
-	cd test ; ${MOCHA} *.js -R spec | tee ../log/mocha.log ; exit $${PIPESTATUS[0]}
-
-# README
-README.md: documentation.md
-	cat documentation.md > README.md
-
-# Mocha Markdown BDD spec
-bdd-spec.md: log/npm-dev-install.log lib/*.js test/*.js
-	cd test ; ${MOCHA} *.js -R markdown > ../bdd-spec.md
-
-# Upgrade version in package.json
-log/upgrade-package.log: lib/*.js test/*.js documentation.md
-	npm version patch -m "Upgrade package.json version to %s" | tee log/upgrade-package.log ; exit $${PIPESTATUS[0]}
-
-# Publish to NPM
-log/npm-publish.log: check-if-master-branch log/upgrade-package.log
-	npm publish | tee log/npm-publish.log ; exit $${PIPESTATUS[0]}
-
-# Push to Github/master
-log/github-push.log: lib/*.js test/*.js package.json
-	#'npm version patch' create the git tag by itself... 
-	#git tag v`cat package.json | grep version | sed -r 's/.*"([0-9.]*)".*/\1/'`
-	git push origin master --tags | tee log/github-push.log ; exit $${PIPESTATUS[0]}
-
-# NPM install
-log/npm-install.log: package.json
-	npm install --production | tee log/npm-install.log ; exit $${PIPESTATUS[0]}
-
-# NPM install for developpement usage
-log/npm-dev-install.log: package.json
-	npm install | tee log/npm-dev-install.log ; exit $${PIPESTATUS[0]}
-
-
-
-# PHONY rules
-
-.PHONY: clean-all check-if-master-branch
-
-# Delete files, mostly log and non-versioned files
-clean-all:
-	rm -rf log/*.log README.md bdd-spec.md node_modules
-
-# This will fail if we are not on master branch (grep exit 1 if nothing found)
-check-if-master-branch:
-	git branch | grep  "^* master$$"
-
-

package/documentation.md

@@ -1,17 +0,0 @@
-
-# Book Source
-
-Book Source is a Lightweight Markup Language similar to Markdown.
-
-This is the parser, you may want to add a renderer, like the [Book Source HTML renderer](https://github.com/cronvel/book-source-html-renderer).
-
-New renderers can easily be created.
-
-The parser has zero regex.
-
-
-
-## Book Source syntax
-
-TODO
-