@selimssevgi/cube-design-angular 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 nothing yet.
 
+## 0.5.1 (4 november 2026: an empty piece has room)
+
+- **`least` on `<cube-square>`** and the pure `squareLeast(side, { cell, min, max })` (`SQUARE_LEAST_CELL`, 200): a dashed square (something can be added) stands at least as many across as keep a place near 200 px, 3 × 3 on a phone, 4 × 4 in a desktop column, 5 × 5 at the widest; past that the tiles grow it as before. an empty piece is its own box first, then dashed places, never one place as wide as the screen (selim's pick, way c of `studies/empty-piece-places.md`, 4 november 2026: "this single add looks ridiculous"). `squareLayout` takes `least` too. on by default (`'room'`) for every dashed square; `[least]="0"` keeps the smallest. a square that is not dashed never changes.
+
+## 0.5.0 (4 november 2026: released so mosaic's home grouped my way brings things in and keeps my own order)
+
+- **bring things in**, `bringOf(source, into, { at, pieces })` and `bringLevel` (`CubeBring`, `BringOptions`, `BringWords`): where turned round (the study `studies/bringing-things-in.md`, way b, picked by selim on 4 november 2026). where lists places for one piece; bring lists pieces for one place: what stands in `at` (the top by default), each ticked when it is in already, the place itself and a piece holding it pale, a › on a piece with something to bring inside it, what a tap asks (`stand`, `take-out`) and why it would be refused, over the same `WhereSource`. `pieces` lists the app's own (lately) instead. from mosaic's grouping prototype (`bring-things-in.html`).
+- **my own order**, `moveBefore(order, piece, before, { fixedFirst })`, `orderOf` and `orderLevel` (`CubeOrderPlace`, `OrderWords`, `OrderRefusal`, `MINE_SORT`): the person orders a place's pieces by hand; the order is the place's, never the piece's, and a fixed first piece the app names (mosaic's apps at its top) stays first. the level is the place's pieces as they come, the held one ticked, a tap puts it before another, **last** at the end.
+- **add as a level**, `addLevel(ways)` (`AddWay`): the app's ways to add to a place as context tiles, the plus last (selim: bring things in first, then the plus with a short line). what add holds is each app's, and may differ from place to place.
+- `ContextPartKey` and `CONTEXT_PART_ORDER` know `bring` (after change) and `order` (after sort), drawn as move and sort (`PART_ICONS`). an app that uses neither sees no change.
+
 ## 0.4.0 (4 november 2026: released so mosaic's home grouped my way draws its context cube with `<cube-context>`)
 
 - `ContextTile.attrs`: the app's own `data-*` attributes on a tile's cell (`cc-cell`, which holds the tile and its ›), so a test or a use-case runner finds the context cube's tiles by the app's own handles (`data-name`, `data-kind`, `data-ticked`). only `data-*` names are set, a null leaves one out, and one a later tile no longer gives is taken off. found moving mosaic's home grouped my way onto `<cube-context>` (4 november 2026): it drew its context cube with its own square only to carry the runner's handles, and so it had no view (selim: "whenever there is a solution in the library, we should make use of it").

package/fesm2022/selimssevgi-cube-design-angular.mjs

@@ -1417,8 +1417,10 @@ i0.ɵɵngDeclareClassMetadata({
 const CONTEXT_PART_ORDER = [
 	"names",
 	"change",
+	"bring",
 	"view",
 	"sort",
+	"order",
 	"move",
 	"where",
 	"whose",
@@ -1432,7 +1434,9 @@ const CONTEXT_CUBE_SOURCE = new InjectionToken("CONTEXT_CUBE_SOURCE");
 const CONTEXT_CUBE_WORDS = new InjectionToken("CONTEXT_CUBE_WORDS");
 const PART_ICONS = {
 	hide: "shown",
-	where: "place"
+	where: "place",
+	bring: "move",
+	order: "sort"
 };
 function partsLevel(parts, words, now = {}) {
 	return orderParts(parts).map((p) => ({
@@ -1505,6 +1509,36 @@ function sortItems(items, by, dir, text = "natural") {
 		return sign * compare(a.value, b.value) || a.at - b.at;
 	}).map((x) => x.item);
 }
+const MINE_SORT = "mine";
+function moveBefore(order, piece, before, opts = {}) {
+	const fixed = opts.fixedFirst ?? null;
+	if (fixed !== null && (piece === fixed || before === fixed)) return {
+		order: [...order],
+		refused: "fixed-first"
+	};
+	if (!order.includes(piece) || before === piece) return {
+		order: [...order],
+		refused: null
+	};
+	const rest = order.filter((p) => p !== piece);
+	const at = before === null ? -1 : rest.indexOf(before);
+	rest.splice(at < 0 ? rest.length : at, 0, piece);
+	return {
+		order: rest,
+		refused: null
+	};
+}
+function orderOf(order, held, opts = {}) {
+	const fixed = opts.fixedFirst ?? null;
+	return order.map((key, at) => ({
+		key,
+		at,
+		held: key === held,
+		fixed: key === fixed,
+		tap: key === held ? null : "before",
+		refused: key !== held && key === fixed ? "fixed-first" : null
+	}));
+}
 function namesLevel(names, words, opts = {}) {
 	const tiles = [...names.filter((n) => n.current), ...names.filter((n) => !n.current).reverse()].map((n, i) => ({
 		key: `name:${i}:${n.name}`,
@@ -1582,6 +1616,36 @@ function sortDirectionsLevel(option, now, words) {
 		data: dir
 	}));
 }
+function orderLevel(places, words) {
+	const tiles = places.map((p) => ({
+		key: "order:" + p.key,
+		title: words.title(p),
+		line: words.line?.(p) ?? null,
+		icon: "sort",
+		inUse: p.held,
+		pale: p.fixed,
+		data: p
+	}));
+	if (places.length && !places[places.length - 1].held) tiles.push({
+		key: "order:last",
+		title: words.last.title,
+		line: words.last.line ?? null,
+		icon: "down",
+		data: null
+	});
+	return tiles;
+}
+function addLevel(ways) {
+	const tile = (w) => ({
+		key: "add:" + w.key,
+		title: w.title,
+		line: w.line ?? null,
+		icon: w.icon ?? (w.adds ? "plus" : "move"),
+		adds: !!w.adds,
+		data: w
+	});
+	return [...ways.filter((w) => !w.adds), ...ways.filter((w) => w.adds)].map(tile);
+}
 function insideOf(source, piece) {
 	const seen = /* @__PURE__ */ new Set();
 	const walk = [...source.partsOf(piece)];
@@ -1698,6 +1762,66 @@ function whereLevel(places, words = {}, opts = {}) {
 		data: p
 	}));
 }
+function bringOf(source, into, opts = {}) {
+	const at = opts.at ?? source.top;
+	const hidden = (id) => !!source.hidden?.(id);
+	const shown = (place) => source.partsOf(place).filter((p) => !hidden(p));
+	const inInto = (p) => source.placesOf(p).includes(into);
+	const can = (p) => p !== into && !inInto(p) && !refusalOf(source, p, into);
+	const reached = /* @__PURE__ */ new Map();
+	const reaches = (q, trail = /* @__PURE__ */ new Set()) => {
+		if (reached.has(q)) return reached.get(q);
+		if (trail.has(q)) return false;
+		trail.add(q);
+		const r = shown(q).some((p) => can(p) || inInto(p) || reaches(p, trail));
+		reached.set(q, r);
+		return r;
+	};
+	return (opts.pieces ? opts.pieces.filter((p) => !hidden(p)) : shown(at)).filter((p) => p !== at || !!opts.pieces).map((p) => {
+		const places = source.placesOf(p);
+		const others = places.filter((q) => q !== into);
+		const deeper = !opts.pieces && shown(p).length > 0 && reaches(p);
+		if (p === into) return {
+			key: p,
+			title: source.nameOf(p),
+			in: false,
+			given: false,
+			into: true,
+			holdsInto: false,
+			tap: null,
+			refused: "inside-itself",
+			places: others,
+			deeper: false
+		};
+		const stands = places.includes(into);
+		const given = (source.givenPlaceOf?.(p) ?? null) === into;
+		return {
+			key: p,
+			title: source.nameOf(p),
+			in: stands,
+			given: stands && given,
+			into: false,
+			holdsInto: !stands && wouldLoop(source, p, into),
+			tap: stands ? "take-out" : "stand",
+			refused: stands ? given ? "given-place" : places.length === 1 ? "last-place" : null : refusalOf(source, p, into),
+			places: others,
+			deeper
+		};
+	});
+}
+function bringLevel(pieces, words = {}, opts = {}) {
+	const pathOf = opts.pathOf ?? ((p) => ["bring", p.key]);
+	return pieces.map((p) => ({
+		key: "bring:" + p.key,
+		title: words.title?.(p) ?? p.title,
+		line: words.line?.(p) ?? null,
+		icon: "place",
+		inUse: p.in,
+		pale: p.tap === null || !p.in && p.refused !== null,
+		zoom: p.deeper ? pathOf(p) : null,
+		data: p
+	}));
+}
 const TURNING_SIDES = 4;
 function turningRows(pieces, own, cols = 3, rows = cols) {
 	const across = Math.max(1, Math.floor(cols));
@@ -1729,11 +1853,18 @@ function squareGap(n) {
 }
 const SQUARE_MAX_SIDE = 880;
 const SQUARE_LIST_ROW = 76;
+const SQUARE_LEAST_CELL = 200;
+function squareLeast(side, opts = {}) {
+	const { cell = 200, min = 3, max = 5 } = opts;
+	if (!(side > 0)) return min;
+	return Math.min(max, Math.max(min, Math.ceil(side / cell)));
+}
 function squareLayout(view, count, room, opts = {}) {
 	const n = Math.max(0, count);
 	const grid = gridFor(view, n);
-	const cols = grid.cols;
-	const rows = view === "square" ? grid.rows : Math.max(1, Math.ceil(n / cols));
+	const least = view === "square" ? Math.max(0, Math.floor(opts.least ?? 0)) : 0;
+	const cols = Math.max(grid.cols, least);
+	const rows = view === "square" ? Math.max(grid.rows, least) : Math.max(1, Math.ceil(n / cols));
 	const width = Math.max(0, Math.min(view === "square" ? Math.min(room.width, room.tall) : room.width, opts.maxSide ?? 880));
 	const list = view === "one";
 	const gap = list ? 8 : squareGap(Math.max(cols, Math.min(rows, 5)));
@@ -1840,6 +1971,7 @@ var CubeSquare = class CubeSquare {
 	maxSide = input(880, ...ngDevMode ? [{ debugName: "maxSide" }] : /* istanbul ignore next */ []);
 	listRow = input(76, ...ngDevMode ? [{ debugName: "listRow" }] : /* istanbul ignore next */ []);
 	dashed = input(false, ...ngDevMode ? [{ debugName: "dashed" }] : /* istanbul ignore next */ []);
+	least = input("room", ...ngDevMode ? [{ debugName: "least" }] : /* istanbul ignore next */ []);
 	keyOf = input((_, i) => i, ...ngDevMode ? [{ debugName: "keyOf" }] : /* istanbul ignore next */ []);
 	turning = input(false, ...ngDevMode ? [{ debugName: "turning" }] : /* istanbul ignore next */ []);
 	turnBelow = input(640, ...ngDevMode ? [{ debugName: "turnBelow" }] : /* istanbul ignore next */ []);
@@ -1865,9 +1997,12 @@ var CubeSquare = class CubeSquare {
 			width,
 			tall: r.tall || width
 		};
+		const least = this.least();
+		const side = Math.min(width, room.tall, this.maxSide());
 		const opts = {
 			maxSide: this.maxSide(),
-			listRow: this.listRow()
+			listRow: this.listRow(),
+			least: !this.dashed() ? 0 : least === "room" ? squareLeast(side) : least
 		};
 		const front = this.front();
 		if (!front) return squareLayout(this.view(), this.tiles().length, room, opts);
@@ -2122,6 +2257,13 @@ var CubeSquare = class CubeSquare {
 				isRequired: false,
 				transformFunction: null
 			},
+			least: {
+				classPropertyName: "least",
+				publicName: "least",
+				isSignal: true,
+				isRequired: false,
+				transformFunction: null
+			},
 			keyOf: {
 				classPropertyName: "keyOf",
 				publicName: "keyOf",
@@ -2467,6 +2609,14 @@ i0.ɵɵngDeclareClassMetadata({
 				required: false
 			}]
 		}],
+		least: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "least",
+				required: false
+			}]
+		}],
 		keyOf: [{
 			type: i0.Input,
 			args: [{
@@ -2822,6 +2972,7 @@ var CubeContext = class CubeContext {
 					"maxSide",
 					"listRow",
 					"dashed",
+					"least",
 					"keyOf",
 					"turning",
 					"turnBelow",
@@ -3165,6 +3316,7 @@ var CubeLoading = class CubeLoading {
 					"maxSide",
 					"listRow",
 					"dashed",
+					"least",
 					"keyOf",
 					"turning",
 					"turnBelow",
@@ -3272,6 +3424,6 @@ i0.ɵɵngDeclareClassMetadata({
 		}]
 	}
 });
-export { CONTEXT_CUBE_SOURCE, CONTEXT_CUBE_WORDS, CONTEXT_PART_ORDER, CUBE_CARRY_CLASSES, CUBE_CARRY_MOVE, CUBE_DROP_OUT, CUBE_HOLD_MS, CUBE_HOLD_SLOP, CUBE_ICON_NAMES, CUBE_LOADING_COLOURS, CUBE_LOADING_LEVELS, CUBE_LOADING_STEP_MS, CUBE_LOADING_STICKERS, CUBE_LOADING_WAYS, CUBE_LOADING_WIDTH, CUBE_PINCH_APART, CUBE_PINCH_TOGETHER, CUBE_WHEEL_QUIET_MS, CubeCarry, CubeContext, CubeHold, CubeIcon, CubeLoading, CubePicture, CubePinch, CubeSquare, CubeSquareTile, PART_ICONS, SQUARE_LIST_ROW, SQUARE_MAX_SIDE, TEXT_ORDERS, TURNING_BELOW, TURNING_NUDGE_UNTIL, TURNING_SIDES, VIEW_KEYS, contextIcon, contextLevelFor, contextSquare, cubeIconCells, directionWords, drawCube, gridFor, hideLevel, insideOf, isView, loadingStickers, loadingWayFor, namesLevel, orderParts, partsLevel, placesOf, refusalOf, sizeFor, sortDirectionsLevel, sortItems, sortLevel, squareGap, squareLayout, squareLevelFor, startsWheelGesture, stillStep, turningFront, turningRows, viewLevel, whereLevel, wouldLoop };
+export { CONTEXT_CUBE_SOURCE, CONTEXT_CUBE_WORDS, CONTEXT_PART_ORDER, CUBE_CARRY_CLASSES, CUBE_CARRY_MOVE, CUBE_DROP_OUT, CUBE_HOLD_MS, CUBE_HOLD_SLOP, CUBE_ICON_NAMES, CUBE_LOADING_COLOURS, CUBE_LOADING_LEVELS, CUBE_LOADING_STEP_MS, CUBE_LOADING_STICKERS, CUBE_LOADING_WAYS, CUBE_LOADING_WIDTH, CUBE_PINCH_APART, CUBE_PINCH_TOGETHER, CUBE_WHEEL_QUIET_MS, CubeCarry, CubeContext, CubeHold, CubeIcon, CubeLoading, CubePicture, CubePinch, CubeSquare, CubeSquareTile, MINE_SORT, PART_ICONS, SQUARE_LEAST_CELL, SQUARE_LIST_ROW, SQUARE_MAX_SIDE, TEXT_ORDERS, TURNING_BELOW, TURNING_NUDGE_UNTIL, TURNING_SIDES, VIEW_KEYS, addLevel, bringLevel, bringOf, contextIcon, contextLevelFor, contextSquare, cubeIconCells, directionWords, drawCube, gridFor, hideLevel, insideOf, isView, loadingStickers, loadingWayFor, moveBefore, namesLevel, orderLevel, orderOf, orderParts, partsLevel, placesOf, refusalOf, sizeFor, sortDirectionsLevel, sortItems, sortLevel, squareGap, squareLayout, squareLeast, squareLevelFor, startsWheelGesture, stillStep, turningFront, turningRows, viewLevel, whereLevel, wouldLoop };
 
 //# sourceMappingURL=selimssevgi-cube-design-angular.mjs.map