@selimssevgi/cube-design-angular 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 nothing yet.
 
+## 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));
@@ -3272,6 +3396,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_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, squareLevelFor, startsWheelGesture, stillStep, turningFront, turningRows, viewLevel, whereLevel, wouldLoop };
 
 //# sourceMappingURL=selimssevgi-cube-design-angular.mjs.map