x4js 2.0.12 → 2.0.14

package/lib/src/components/base.scss

@@ -1,26 +1,25 @@
-/** 
- *  ___  ___ __
- *  \  \/  /  / _
- *   \    /  /_| |_
- *   /    \____   _|  
- *  /__/\__\   |_|
- * 
- * @file base.scss
- * @author Etienne Cochard 
- * 
- * @copyright (c) 2024 R-libre ingenierie
- *
- * Use of this source code is governed by an MIT-style license 
- * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
- **/
-
-@use "./shared.scss";
-
-.x4box {
-	@extend .box;
-}
-
-.x4flex {
-	@extend .flex;
-}
-
+/** 
+ *  ___  ___ __
+ *  \  \/  /  / _
+ *   \    /  /_| |_
+ *   /    \____   _|  
+ *  /__/\__\   |_|
+ * 
+ * @file base.scss
+ * @author Etienne Cochard 
+ * 
+ * @copyright (c) 2024 R-libre ingenierie
+ *
+ * Use of this source code is governed by an MIT-style license 
+ * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
+ **/
+
+@use "./shared.scss";
+
+.x4box {
+	@extend .box;
+}
+
+.x4flex {
+	@extend .flex;
+}

package/lib/src/components/boxes/boxes.module.scss

@@ -1,37 +1,54 @@
-/** 
- *  ___  ___ __
- *  \  \/  /  / _
- *   \    /  /_| |_
- *   /    \____   _|  
- *  /__/\__\   |_|
- * 
- * @file boxes.module.scss
- * @author Etienne Cochard 
- * 
- * @copyright (c) 2024 R-libre ingenierie
- *
- * Use of this source code is governed by an MIT-style license 
- * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
- **/
-
-@use "../shared.scss";
-
-.x4hbox {
-	@extend .hbox;
-}
-
-.x4vbox {
-	@extend .vbox;
-}
-
-.x4stackbox {
-	&>* {
-		@extend .fit;
-		position: relative !important;
-	}
-
-	&>*:not(.selected) {
-		display: none;
-	}
-}
-
+/** 
+ *  ___  ___ __
+ *  \  \/  /  / _
+ *   \    /  /_| |_
+ *   /    \____   _|  
+ *  /__/\__\   |_|
+ * 
+ * @file boxes.module.scss
+ * @author Etienne Cochard 
+ * 
+ * @copyright (c) 2024 R-libre ingenierie
+ *
+ * Use of this source code is governed by an MIT-style license 
+ * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
+ **/
+
+@use "../shared.scss";
+
+.x4hbox {
+	@extend .hbox;
+	&.align-start {
+		align-items: start;
+	}
+}
+
+.x4vbox {
+	@extend .vbox;
+}
+
+.x4stackbox {
+	display: flex;
+	
+	&>* {
+		@extend .fit;
+		position: relative !important;
+	}
+
+	&>*:not(.selected) {
+		display: none;
+	}
+}
+
+.x4gridbox {
+	display: grid;
+}
+
+.x4masonrybox {
+	display: grid;
+	grid-gap: 10px;
+	grid-template-columns: repeat(auto-fill, minmax(250px,1fr));
+	grid-auto-rows: 10px;
+
+	overflow: hidden;
+}

package/lib/src/components/boxes/boxes.ts

@@ -1,125 +1,278 @@
-/** 
- *  ___  ___ __
- *  \  \/  /  / _
- *   \    /  /_| |_
- *   /    \____   _|  
- *  /__/\__\   |_|
- * 
- * @file boxes.ts
- * @author Etienne Cochard 
- * 
- * @copyright (c) 2024 R-libre ingenierie
- *
- * Use of this source code is governed by an MIT-style license 
- * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
- **/
-
-import { Component, ComponentEvents, ComponentProps } from "../../core/component"
-
-import "./boxes.module.scss";
-
-export interface BoxProps extends ComponentProps {
-}
-
-/**
- * 
- */
-
-export class Box<P extends BoxProps=BoxProps,E extends ComponentEvents=ComponentEvents> extends Component<P,E> {
-}
-
-
-/**
- * 
- */
-
-export class HBox<P extends BoxProps=BoxProps,E extends ComponentEvents=ComponentEvents> extends Box<P,E> {
-}
-
-/**
- * 
- */
-
-export class VBox<P extends BoxProps=BoxProps,E extends ComponentEvents=ComponentEvents> extends Box<P,E> {
-	constructor( p: P ) {
-		super( p );
-	}
-}
-
-
-/**
- * stack of widgets where only one widget is visible at a time
- */
-
-interface StackItem {
-	name: string;
-	content: Component;
-}
-
-interface StackedLayoutProps extends Omit<ComponentProps,"content"> {
-	default: string;
-	items: StackItem[];
-}
-
-interface _StackItem extends StackItem {
-	page: Component;
-}
-
-export class StackBox extends Box<StackedLayoutProps> {
-
-	private _items: _StackItem[];
-
-	constructor( props: StackedLayoutProps ) {
-		super( props );
-
-		this._items = props.items?.map( itm => {
-			return { ...itm, page: null };
-		});
-
-		if( props.default ) {
-			this.select( props.default );
-		}
-		else if( this._items.length ) {
-			this.select( this._items[0].name );
-		}
-	}
-
-	select( name: string ) {
-		let sel = this.query( `.selected` );
-		if( sel ) {
-			sel.setClass( "selected", false );
-		}
-
-		const pg = this._items.find( x => x.name==name );
-		if( pg ) {
-			if( !pg.page ) {
-				pg.page = this._createPage( pg );
-				this.appendContent( pg.page );
-			}
-
-			sel = pg.page;
-			if( sel ) {
-				sel.setClass( "selected", true );
-			}
-		}
-	}
-
-	/**
-	 * 
-	 */
-
-	private _createPage( page: _StackItem ) {
-		
-		let content: Component;
-		//if( page.content instanceof ComponentBuilder ) {
-		//	content = page.content.create( );
-		//}
-		//else {
-			content = page.content;
-		//}
-		
-		content?.setData( "stackname", page.name );
-		return content;
-	}
-}
-
+/** 
+ *  ___  ___ __
+ *  \  \/  /  / _
+ *   \    /  /_| |_
+ *   /    \____   _|  
+ *  /__/\__\   |_|
+ * 
+ * @file boxes.ts
+ * @author Etienne Cochard 
+ * 
+ * @copyright (c) 2024 R-libre ingenierie
+ *
+ * Use of this source code is governed by an MIT-style license 
+ * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
+ **/
+
+import { class_ns, isArray, isNumber, isString } from '@core/core_tools.js';
+import { Component, ComponentContent, ComponentEvents, ComponentProps } from "../../core/component"
+
+import "./boxes.module.scss";
+
+export interface BoxProps extends ComponentProps {
+	tag?: string;
+}
+
+/**
+ * 
+ */
+
+@class_ns( "x4" )
+export class Box<P extends BoxProps=BoxProps,E extends ComponentEvents=ComponentEvents> extends Component<P,E> {
+}
+
+
+/**
+ * 
+ */
+
+@class_ns( "x4" )
+export class HBox<P extends BoxProps=BoxProps,E extends ComponentEvents=ComponentEvents> extends Box<P,E> {
+}
+
+/**
+ * 
+ */
+
+@class_ns( "x4" )
+export class VBox<P extends BoxProps=BoxProps,E extends ComponentEvents=ComponentEvents> extends Box<P,E> {
+	constructor( p: P ) {
+		super( p );
+	}
+}
+
+
+/**
+ * stack of widgets where only one widget is visible at a time
+ */
+
+type ContentBuilder = ( ) => Component;
+
+interface StackItem {
+	name: string;
+	content: Component | ContentBuilder;
+}
+
+interface StackedLayoutProps extends Omit<ComponentProps,"content"> {
+	default: string;
+	items: StackItem[];
+}
+
+interface StackItemEx extends StackItem {
+	page: Component;
+}
+
+@class_ns( "x4" )
+export class StackBox extends Box<StackedLayoutProps> {
+	private _items: StackItemEx[];
+
+	constructor( props: StackedLayoutProps ) {
+		super( props );
+
+		this._items = props.items?.map( itm => {
+			return { ...itm, page: null as any};
+		});
+
+		if( props.default ) {
+			this.select( props.default );
+		}
+		else if( this._items.length ) {
+			this.select( this._items[0].name );
+		}
+	}
+
+	addItem( item: StackItem ) {
+		this._items.push( {
+			name: item.name,
+			content: item.content,
+			page: null
+		});
+	}
+
+	select( name: string ) {
+		let sel = this.query( `:scope > .selected` );
+		if( sel ) {
+			sel.setClass( "selected", false );
+		}
+
+		const pg = this._items.find( x => x.name==name );
+		if( pg ) {
+			if( !pg.page ) {
+				pg.page = this._createPage( pg );
+				this.appendContent( pg.page );
+			}
+
+			sel = pg.page;
+			if( sel ) {
+				(sel as any).activate?.( );
+				sel.setClass( "selected", true );
+			}
+		}
+
+		return pg?.page;
+	}
+
+	/**
+	 * 
+	 */
+
+	private _createPage( page: StackItemEx ) {
+		
+		let content: Component;
+		if( page.content instanceof Function ) {
+			content = page.content( );
+			page.content = content;	// keep it
+		}
+		else {
+			content = page.content;
+		}
+		
+		content?.setData( "stackname", page.name );
+		return content;
+	}
+
+	/**
+	 * 
+	 */
+	
+	getPage( name: string ) {
+		const pg = this._items.find( x => x.name==name );
+		return pg ? pg.content : null;
+	}
+}
+
+// :: GRIDBOX ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+
+
+export interface GridboxProps extends BoxProps {
+	rows?: number | string | string[];
+	columns?: number | string | string[];
+}
+
+@class_ns("x4")
+export class GridBox<P extends GridboxProps=GridboxProps,E extends ComponentEvents=ComponentEvents> extends Box<P,E> {
+
+	constructor( props: P ) {
+		super( props );
+
+		if( props.rows!==undefined ) {
+			this.setRows( props.rows );
+		}
+
+		if( props.columns!==undefined ) {
+			this.setCols( props.columns );
+		}
+	}
+
+	setRows( r: number | string | string[] ) {
+		if( isArray(r) ) {
+			r = r.join( " " );
+		}
+		else if( isNumber(r) ) {
+			r = `repeat( ${r}, 1fr )`;
+		}
+
+		this.setStyleValue( "gridTemplateRows", r );
+	}
+
+	setCols( r: number | string | string[] ) {
+		if( isArray(r) ) {
+			r = r.join( " " );
+		}
+		else if( isNumber(r) ) {
+			r = `repeat( ${r}, 1fr )`;
+		}
+
+		this.setStyleValue( "gridTemplateColumns", r );
+	}
+
+	setRowCount( n: number ) {
+		this.setStyleValue( "gridTemplateRows", `repeat(${n})` );
+	}
+
+	setColCount( n: number ) {
+		this.setStyleValue( "gridTemplateColumns", `repeat(${n})` );
+	}
+
+	/**
+	 * @param t "a a a" "b c c" "b c c"
+	 * user item.setAttribute( "grid-area", "a" );
+	 */
+
+	setTemplate( t: string[] ) {
+		this.setAttribute( "grid-template-area", t.map( x => '"' + x + '"' ).join(" ") );
+	}
+}
+
+
+// :: MASONRY ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
+
+// from a nice article of Andy Barefoot
+//	https://medium.com/@andybarefoot/a-masonry-style-layout-using-css-grid-8c663d355ebb
+
+interface MasonryProps extends Omit<BoxProps,"content"> {
+	items: Component[];
+}
+
+@class_ns("x4")
+export class MasonryBox extends Box<MasonryProps> {
+
+	constructor(props: MasonryProps ) {
+		super(props);
+
+		this.addDOMEvent( 'resized', () => {
+			this.resizeAllItems( );
+		});
+
+		if( props.items ) {
+			this.setItems( props.items );
+		}
+	}
+
+	resizeItem(item: Component) {
+		const style = this.getComputedStyle();
+
+		const rowHeight = parseInt(style['gridAutoRows']);
+		const rowGap = parseInt(style['rowGap']);
+
+		let content = item.query('.content');
+		if( !content ) {
+			content = item;
+		}
+
+		if (content && (rowHeight + rowGap)) {
+			const rc = content.getBoundingRect();
+			const rowSpan = Math.ceil( (rc.height + rowGap) / (rowHeight + rowGap) );
+			item.setStyleValue('gridRowEnd', "span " + rowSpan);
+		}
+	}
+	  
+	resizeAllItems( ) {
+		const els = this.queryAll( ".item" );
+		els.forEach( itm => {;
+			this.resizeItem( itm );
+		} );
+	}
+
+	setItems( items: Component[] ) {
+		const els = items.map( x => {
+			return new Box( {
+				cls: 'item',
+				content: x
+			} );
+		});
+		
+		this.setContent( els );
+	}
+}
+

package/lib/src/components/breadcrumb/breadcrumb.scss

@@ -0,0 +1,56 @@
+
+:root {
+	--breadcrumbs-background: var( --background-primary );
+	--breadcrumbs-icon-color: var( --text-ternary );
+	--breadcrumbs-link-color: var( --text-ternary );
+	--breadcrumbs-active-color: var( --accent-background );
+}
+
+.x4breadcrumbs {
+	background-color: var( --breadcrumbs-background );
+	border-bottom: 1px solid var( --border );
+	padding: 8px 0;
+	margin-bottom: 2em;
+		
+	&> .x4button {
+		border: none;
+		background-color: transparent;
+		color: var( --breadcrumbs-link-color );
+		padding: 6px 8px;
+		padding-right: 0;
+		min-width: 60px;
+
+		#icon {
+			fill: var( --breadcrumbs-icon-color );
+		}
+
+		&:not(:last-child):after {
+			content: ">"
+		}
+	
+		&:hover:not(:last-child) {
+			background-color: transparent;
+			color: var( --accent-background );
+			fill:  var( --accent-background );
+			border-bottom-color: var( --breadcrumbs-link-color );
+			#text {
+				text-decoration: underline;
+			}
+		}
+
+		&:last-child {
+			font-weight: bold;
+			color: var( --breadcrumbs-active-color );
+
+			#icon {
+				fill:  var( --breadcrumbs-active-color );
+			}
+
+			cursor: auto;
+			&:hover {
+				background-color: transparent;
+				color: var( --breadcrumbs-link-color );
+			}
+		}
+	}
+}

package/lib/src/components/breadcrumb/breadcrumb.ts

@@ -0,0 +1,93 @@
+/** 
+ *  ___  ___ __
+ *  \  \/  /  / _
+ *   \    /  /_| |_
+ *   /    \____   _|  
+ *  /__/\__\   |_|
+ * 
+ * @file breadcrumb.ts
+ * @author Etienne Cochard 
+ * 
+ * @copyright (c) 2024 R-libre ingenierie
+ *
+ * Use of this source code is governed by an MIT-style license 
+ * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
+ **/
+
+import { class_ns } from '@core/core_tools.js';
+import { parseRoute, Router } from '@core/core_router.js';
+
+import { BoxProps, Button, HBox, Icon } from '../components';
+import { Component, ComponentEvents, EvClick } from '@core/component.js';
+import { EventCallback } from '@core/core_events.js';
+
+import "./breadcrumb.scss"
+
+import icon_sep from "./chevron-right.svg"
+
+/**
+ * Breadcrumb events
+ */
+
+interface BreadcrumbEvents extends ComponentEvents {
+	click: EvClick;	// context = item name
+}
+
+/**
+ * 
+ */
+
+interface BreadcrumbElement {
+	name?: string;
+	icon?: string;
+    label: string;
+	click?: ( name: string ) => void;
+}
+
+/**
+ * 
+ */
+
+interface BreadcrumbsProps extends BoxProps{
+	items: BreadcrumbElement[];
+	click?: EventCallback<EvClick>;
+}
+
+/**
+ * 
+ */
+
+@class_ns( "x4" )
+export class Breadcrumbs extends HBox<BreadcrumbsProps,BreadcrumbEvents> {
+
+	constructor( props: BreadcrumbsProps ) {
+		super( props );
+
+		this.mapPropEvents( props, "click" );
+
+		if( props.items ) {
+			this.setItems( props.items );
+		}
+	}
+
+	setItems( elements: BreadcrumbElement[ ] ) {
+
+		const items = elements.map( itm => {
+			return new Button( {
+				label: itm.label,
+				icon: itm.icon,
+				click: ( ) => {
+					if( itm.click ) {
+						itm.click( itm.name );
+					}
+					else {
+						this.fire( "click", { context: itm.name } );
+					}
+				}
+			})
+		});
+
+		this.setContent( items );
+	}
+}
+

package/lib/src/components/breadcrumb/chevron-right.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--!Font Awesome Pro 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2024 Fonticons, Inc.--><path d="M299.3 244.7c6.2 6.2 6.2 16.4 0 22.6l-192 192c-6.2 6.2-16.4 6.2-22.6 0s-6.2-16.4 0-22.6L265.4 256 84.7 75.3c-6.2-6.2-6.2-16.4 0-22.6s16.4-6.2 22.6 0l192 192z"/></svg>