')
				   .addClass('v-block list'))
		return browser
	},
}
// XXX need to scroll only the list, keeping the path always in view...
// XXX need to handle long paths -- smart shortening or auto scroll...
// XXX Q: should we make a base list dialog and build this on that or
//		simplify this to implement a list (removing the path and disbling
//		traversal)??
// XXX need base events:
//		- open
//		- update
//		- select (???)
// XXX add "current selection" to the path...
var BrowserPrototype = {
	dom: null,
	// option defaults and doc...
	//
	// XXX add enable/disable filter option...
	options: {
		//path: null,
		//show_path: null,
		// handle keys that are not bound...
		//
		// NOTE: to disable, set ot undefined.
		logKeys: function(k){ window.DEBUG && console.log(k) },
	},
	// XXX this should prevent event handler deligation...
	keyboard: {
		// filter mappings...
		Filter: {
			pattern: '.browse .path div.cur[contenteditable]',
			// keep text editing action from affecting the seelction...
			ignore: [
					'Backspace',
					'Left',
					'Right',
					'Home',
					'End',
					'Enter',
					'Esc',
					'/',
				],
			Enter: 'action!',
			Esc: 'stopFilter!',
		},
		General: {
			pattern: '.browse',
			Up: 'prev!',
			Backspace: 'Up',
			Down: 'next!',
			Left: 'pop',
			Right: 'push',
			Home: 'select!: "first"',
			End: 'select!: "last"',
			// XXX add page up and page down...
			// XXX
			// XXX ctrl-Left to go to root/base/home
			// XXX
			Enter: 'action',
			Esc: 'close',
			'/': 'startFilter!',
		},
	},
	// base api...
	// NOTE: to avoid duplicating and syncing data, the actual path is 
	//		stored in DOM...
	// XXX does the path includes the currently selected element?
	get path(){
		var skip = false
		return this.dom.find('.path .dir:not(.cur)')
			.map(function(i, e){ return $(e).text() })
			.toArray()
	},
	set path(value){
		// XXX normalize path...
		return this.update(value)
	},
	// update path...
	// 	- build the path
	// 	- build the element list
	//
	// XXX trigger an "update" event...
	update: function(path){
		path = path || this.path
		var browser = this.dom
		var that = this
		var p = browser.find('.path').empty()
		var l = browser.find('.list').empty()
		var c = []
		// fill the path field...
		path.forEach(function(e){
			c.push(e)
			var cur = c.slice()
			p.append($('
')
				.addClass('dir')
				.click(function(){
					that
						.update(cur.slice(0, -1)) 
						.select('"'+cur.pop()+'"')
				})
				.text(e))
		})
		// add current selction indicator...
		p.append($('
')
			.addClass('dir cur')
			.click(function(){
				that.startFilter()
				//that.update(path.concat($(this).text())) 
				// XXX HACK: prevents the field from bluring when clicked...
				// 			...need to find a better way...
				that._hold_blur = true
				setTimeout(function(){ delete that._hold_blur }, 20)
			})
			// XXX for some reason this gets triggered when clicking ano 
			// 		is not triggered when entering via '/'
			.on('blur', function(){
				// XXX HACK: prevents the field from bluring when clicked...
				// 			...need to find a better way...
				if(!that._hold_blur){
					that.stopFilter()
				}
				//that.stopFilter()
			})
			.keyup(function(){
				that.showFiltered($(this).text())
			}))
		// fill the children list...
		this.list(path)
			.forEach(function(e){
				l.append($('
')
					.click(function(){
						// handle clicks ONLY when not disabled...
						if(!$(this).hasClass('disabled')){
							that.update(that.path.concat([$(this).text()])) 
						}
					})
					.text(e))
			})
		return this
	},
	// Filter the item list...
	//
	// 	General signature...
	// 	.filter(
[, ][, ])
	// 		-> elements
	// 	
	//
	// 	Get all elements...
	// 	.filter()
	// 	.filter('*')
	// 		-> all elements
	//
	// 	Get all elements containing a string...
	// 	.filter()
	// 		-> elements
	//
	// 	Get all elements matching a regexp...
	// 	.filter()
	// 		-> elements
	//
	// 	Filter the elements via a function...
	// 	.filter()
	// 		-> elements
	//
	//
	// If  function is passed it will get called with 
	// every element that was rejected by the predicate / not matching 
	// the pattern.
	//
	// By default,  is false, thus this will ignore 
	// disabled elements. If  is false then disabled 
	// elements will be searched too.
	//
	//
	// XXX pattern modes:
	// 		- lazy match
	// 			abc		-> *abc*		-> ^.*abc.*$
	// 			ab cd	-> *ab*cd*		-> ^.*ab.*cd.*$
	// 		- glob
	// XXX need to support glob / nested patterns...
	// 		..things like /**/a*/*moo/
	// XXX should we unwrap the elements to be more compatible with 
	// 		jQuery .filter(..)?
	filter: function(pattern, a, b){
		pattern = pattern || '*'
		var ignore_disabled = typeof(a) == typeof(true) ? a : b
		ignore_disabled = ignore_disabled == null ? true : ignore_disabled
		var rejected = typeof(a) == typeof(true) ? null : a
		var that = this
		var browser = this.dom
		var elems = browser.find('.list>div' + (ignore_disabled ? ':not(disabled)' : ''))
		if(pattern == '*'){
			return elems 
		}
		// function...
		if(typeof(pattern) == typeof(function(){})){
			var filter = function(i, e){
				if(!pattern.call(e, i, e)){
					if(rejected){
						rejected.call(e, i, e)
					}
					return false
				}
				return true
			}
		// regexp...
		} else if(typeof(pattern) == typeof(/regexp/)){
			var filter = function(i, e){
				if(!pattern.test($(e).text())){
					if(rejected){
						rejected.call(e, i, e)
					}
					return false
				}
				return true
			}
		// string...
		// XXX support glob...
		} else if(typeof(pattern) == typeof('str')){
			var filter = function(i, e){
				e = $(e)
				var t = e.text()
				var i = t.search(pattern)
				if(!(i >= 0)){
					if(rejected){
						rejected.call(e, i, e)
					}
					return false
				}
				return true
			}
		}
		return elems.filter(filter)
	},
	// internal actions...
	
	// NOTE: this uses .filter(..) for actual filtering...
	// XXX revise API...
	showFiltered: function(pattern){
		var that = this
		var browser = this.dom
		// show all...
		if(pattern == null || pattern.trim() == '*'){
			browser.find('.filtered-out')
				.removeClass('filtered-out')
			// clear the highlighting...
			browser.find('.list b')
				.replaceWith(function() { return this.innerHTML })
		// basic filter...
		} else {
			this.filter(pattern,
					// rejected...
					function(i, e){
						e
							.addClass('filtered-out')
							.removeClass('selected')
					})
				// passed...
				.removeClass('filtered-out')
				.each(function(_, e){
					e = $(e)
					var t = e.text()
					e.html(t.replace(pattern, pattern.bold()))
				})
		}
		return this
	},
	// XXX make this a toggler... (???)
	startFilter: function(){
		var range = document.createRange()
		var selection = window.getSelection()
		var that = this
		var e = this.dom.find('.path .dir.cur')
			.text('')
			.attr('contenteditable', true)
			.focus()
		// place the cursor...
		range.setStart(e[0], 0)
		range.collapse(true)
		selection.removeAllRanges()
		selection.addRange(range)
		return this
	},
	stopFilter: function(){
		this.showFiltered('*')
		this.dom.find('.path .dir.cur')
			.text('')
			.removeAttr('contenteditable')
		this
			.focus()
		return this
	},
	get filtering(){
		return this.dom.find('.path .dir.cur[contenteditable]').length > 0 
	},
	toggleFilterMode: function(){
		this.dom.toggleClass('show-filtered-out')
		return this
	},
	// Select a list element...
	//
	//	Get selected element if it exists, otherwise select and return 
	//	the first...
	//	.select()
	//		-> elem
	//
	//	Get selected element if it exists, null otherwise...
	//	.select('!')
	//		-> elem
	//		-> $()
	//
	//	Select first/last child
	//	.select('first')
	//	.select('last')
	//		-> elem
	//
	//	Select previous/next child
	//	.select('prev')
	//	.select('next')
	//		-> elem
	//
	//	Deselect
	//	.select('none')
	//		-> $()
	//
	//	Select element by sequence number
	//	NOTE: negative numbers count from the tail.
	//	NOTE: overflowing selects the first/last element.
	//	.select()
	//		-> elem
	//
	//	Select element by its text...
	//	NOTE: if text matches one of the reserved commands above use 
	//		quotes to escape it...
	//	.select('')
	//	.select("''")
	//	.select('""')
	//		-> elem
	//
	//	Select element via a regular expression...
	//	.select()
	//		-> elem
	//		-> $()
	//
	//	Select jQuery object...
	//	.select()
	//		-> elem
	//		-> $()
	//
	// This will return a jQuery object.
	//
	// NOTE: if multiple matches occur this will select the first.
	// NOTE: 'none' will always return an empty jQuery object, to get 
	// 		the selection state before deselecting use .select('!')
	// NOTE: this uses .filter(..) for string and regexp matching...
	//
	//
	// XXX Q: should this trigger a "select" event???
	// XXX the scroll handling might be a bit inaccurate...
	select: function(elem, filtering){
		var pattern = '.list div:not(.disabled):not(.filtered-out)'
		var browser = this.dom
		var elems = browser.find(pattern)
		filtering = filtering == null ? this.filtering : filtering
		if(elems.length == 0){
			return $()
		}
		// empty list/string selects none...
		elem = elem != null && elem.length == 0 ? 'none' : elem
		// 0 or no args (null) selects first...
		elem = elem == 0 ? 'first' : elem
		// no args -> either we start with the selected or the first...
		if(elem == null){
			var cur = this.select('!')
			elem = cur.length == 0 ? 'first' : cur
		}
		// first/last...
		if(elem == 'first' || elem == 'last'){
			return this.select(elems[elem](), filtering)
		
		// prev/next...
		} else if(elem == 'prev' || elem == 'next'){
			var to = this.select('!', filtering)[elem + 'All'](pattern).first()
			if(to.length == 0){
				return this.select(elem == 'prev' ? 'last' : 'first', filtering)
			}
			this.select('none', filtering)
			return this.select(to, filtering)
		// deselect...
		} else if(elem == 'none'){
			if(!filtering){
				browser.find('.path .dir.cur').empty()
			}
			elems
				.filter('.selected')
				.removeClass('selected')
			return $()
		// strict...
		} else if(elem == '!'){
			return elems.filter('.selected')
		// number...
		// NOTE: on overflow this will get the first/last element...
		} else if(typeof(elem) == typeof(123)){
			return this.select($(elems.slice(elem)[0] || elems.slice(-1)[0] ), filtering)
		// string...
		} else if(typeof(elem) == typeof('str')){
			if(/^'.*'$|^".*"$/.test(elem.trim())){
				elem = elem.trim().slice(1, -1)
			}
			return this.select(this.filter(elem).first(), filtering)
		// regexp...
		} else if(elem.constructor === RegExp){
			return this.select(this.filter(elem).first(), filtering)
		// element...
		} else {
			elem = $(elem).first()
			if(elem.length == 0){
				this.select(null, filtering)
			} else {
				this.select('none', filtering)
				if(!filtering){
					browser.find('.path .dir.cur').text(elem.text())
				}
				// handle scroll position...
				var p = elem.scrollParent()
				var S = p.scrollTop()
				var H = p.height()
				var h = elem.height()
				var t = elem.offset().top - p.offset().top
				var D = 3 * h 
				// too low...
				if(t+h+D > H){
					p.scrollTop(S + (t+h+D) - H)
				// too high...
				} else if(t < D){
					p.scrollTop(S + t - D)
				}
				return elem.addClass('selected')
			}
		}
	},
	// Select next element...
	next: function(elem){
		if(elem != null){
			this.select(elem)
		}
		this.select('next')
		return this
	},
	// Select previous element...
	prev: function(elem){
		if(elem != null){
			this.select(elem)
		}
		this.select('prev')
		return this
	},
	// Push an element to path / go down one level...
	push: function(elem){
		var browser = this.dom 
		var elem = this.select(elem || '!')
		// nothing selected, select first and exit...
		if(elem.length == 0){
			this.select()
			return this
		}
		var path = this.path
		path.push(elem.text())
		// if not traversable call the action...
		if(this.isTraversable != null 
				&& (this.isTraversable !== false
					|| ! this.isTraversable(path))){
			return this.action(path)
		}
		this.path = path
		this.select()
		return this
	},
	// Pop an element off the path / go up one level...
	pop: function(){
		var browser = this.dom
		var path = this.path
		var dir = path.pop()
		this.update(path)
		this.select('"'+dir+'"')
		return this
	},
	focus: function(){
		this.dom.focus()
		return this
	},
	// XXX think about the API...
	// XXX trigger an "open" event...
	action: function(){
		var elem = this.select('!')
		// nothing selected, select first and exit...
		if(elem.length == 0){
			this.select()
			return this
		}
		var path = this.path
		path.push(elem.text())
		var res = this.open(path)
		return res
	},
	// extension methods...
	// XXX this is wrong...
	// 		...need to actually open something...
	open: function(path){ 
		path = path || this.path
		var m = this.options.list
		return m ? m.call(this, path) : path
	},
	list: function(path){
		path = path || this.path
		var m = this.options.list
		return m ? m.call(this, path) : []
	},
	isTraversable: null,
	// XXX need to get a container....
	// XXX setup instance events...
	__init__: function(parent, options){
		options = options || {}
		// merge options...
		var opts = Object.create(this.options)
		Object.keys(options).forEach(function(n){ opts[n] = options[n] })
		options = this.options = opts
		// build the dom...
		var dom = this.dom = this.constructor.make(options)
		// add keyboard handler...
		dom.keydown(
			keyboard.makeKeyboardHandler(
				this.keyboard,
				options.logKeys,
				this))
		// attach to parent...
		if(parent != null){
			parent.append(dom)
		}
		// load the initial state...
		this.update(this.path)
	},
}
/*
var Browser = 
//module.Browser = 
object.makeConstructor('Browser', 
		BrowserClassPrototype, 
		BrowserPrototype)
*/
/**********************************************************************
* vim:set ts=4 sw=4 :                                                */