@selimssevgi/cube-design-angular 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 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").
+
 ## 0.3.0 (3 november 2026: released so cubes, anlat and mosaic take the pinch and the loading look; selim, "the rest can be done")
 
 - **on its way**, `<cube-loading>` (`CubeLoading`, `CubeLoadingWay`, `CUBE_LOADING_WAYS`, `CubeLoadingLevel`, `CUBE_LOADING_LEVELS`, `loadingWayFor`, `loadingStickers`, `stillStep`, `CUBE_LOADING_STEP_MS`, `CUBE_LOADING_WIDTH`, `CUBE_LOADING_COLOURS`, `CUBE_LOADING_STICKERS`): something on its way, the cube design way (selim's decision of 3 november 2026, the study `studies/loading-pieces.md`, finding G3). a page or a cube shows the picture's pale stickers taking colour one by one (`fill`), with the square's places pale below on a page; a piece (a tile, a button saving) shows a small cube whose colours turn round its stickers (`turn`), in place of a ring. `level` (`page`, `cube`, `piece`), `way` (null is the level's), `count`, `colours`, `width`, and `failed`: the picture rests pale, never red, beside the app's own retry (`[cubeLoadingRetry]`). no words: the app projects its line. `prefers-reduced-motion` stops it; `aria-busy` and a polite live line. `--cube-loading-place` and `--cube-loading-gap` in both token files. the places wait and the cube grows stay options to add.

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

@@ -1,5 +1,5 @@
 import * as i0 from "@angular/core";
-import { ChangeDetectionStrategy, Component, DestroyRef, Directive, ElementRef, InjectionToken, PLATFORM_ID, TemplateRef, afterNextRender, computed, contentChild, effect, inject, input, output, signal, untracked, viewChild } from "@angular/core";
+import { ChangeDetectionStrategy, Component, DestroyRef, Directive, ElementRef, InjectionToken, PLATFORM_ID, Renderer2, TemplateRef, afterNextRender, computed, contentChild, effect, inject, input, output, signal, untracked, viewChild } from "@angular/core";
 import { NgTemplateOutlet, isPlatformBrowser } from "@angular/common";
 function sizeFor(count) {
 	let s = 1;
@@ -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));
@@ -2545,6 +2669,64 @@ function contextIcon(tile) {
 	if (tile.icon === "hide") return "shown";
 	return "face";
 }
+var ContextAttrs = class ContextAttrs {
+	ccAttrs = input(...ngDevMode ? [void 0, { debugName: "ccAttrs" }] : /* istanbul ignore next */ []);
+	el = inject(ElementRef);
+	renderer = inject(Renderer2);
+	set = [];
+	constructor() {
+		effect(() => {
+			const attrs = this.ccAttrs() ?? {};
+			const node = this.el.nativeElement;
+			const next = Object.keys(attrs).filter((k) => k.startsWith("data-") && attrs[k] != null);
+			for (const k of this.set) if (!next.includes(k)) this.renderer.removeAttribute(node, k);
+			for (const k of next) this.renderer.setAttribute(node, k, attrs[k]);
+			this.set = next;
+		});
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.4",
+		ngImport: i0,
+		type: ContextAttrs,
+		deps: [],
+		target: i0.ɵɵFactoryTarget.Directive
+	});
+	static ɵdir = i0.ɵɵngDeclareDirective({
+		minVersion: "17.1.0",
+		version: "22.2.4",
+		type: ContextAttrs,
+		isStandalone: true,
+		selector: "[ccAttrs]",
+		inputs: { ccAttrs: {
+			classPropertyName: "ccAttrs",
+			publicName: "ccAttrs",
+			isSignal: true,
+			isRequired: false,
+			transformFunction: null
+		} },
+		ngImport: i0
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.4",
+	ngImport: i0,
+	type: ContextAttrs,
+	decorators: [{
+		type: Directive,
+		args: [{ selector: "[ccAttrs]" }]
+	}],
+	ctorParameters: () => [],
+	propDecorators: { ccAttrs: [{
+		type: i0.Input,
+		args: [{
+			isSignal: true,
+			alias: "ccAttrs",
+			required: false
+		}]
+	}] }
+});
 var CubeContext = class CubeContext {
 	held = input.required(...ngDevMode ? [{ debugName: "held" }] : /* istanbul ignore next */ []);
 	path = input([], ...ngDevMode ? [{ debugName: "path" }] : /* istanbul ignore next */ []);
@@ -2696,7 +2878,7 @@ var CubeContext = class CubeContext {
       [class.cc-adds]="adds()"
     >
       <ng-template [cubeSquareTile]="tiles()" let-t let-level="level">
-        <div class="cc-cell">
+        <div class="cc-cell" [ccAttrs]="t.attrs">
           <button
             type="button"
             [class]="'cc-tile cc-l' + level"
@@ -2777,6 +2959,12 @@ var CubeContext = class CubeContext {
 				type: CubeSquareTile,
 				selector: "ng-template[cubeSquareTile]",
 				inputs: ["cubeSquareTile"]
+			},
+			{
+				kind: "directive",
+				type: ContextAttrs,
+				selector: "[ccAttrs]",
+				inputs: ["ccAttrs"]
 			}
 		],
 		changeDetection: i0.ChangeDetectionStrategy.OnPush
@@ -2794,7 +2982,8 @@ i0.ɵɵngDeclareClassMetadata({
 			imports: [
 				CubeIcon,
 				CubeSquare,
-				CubeSquareTile
+				CubeSquareTile,
+				ContextAttrs
 			],
 			template: `
     <cube-square
@@ -2805,7 +2994,7 @@ i0.ɵɵngDeclareClassMetadata({
       [class.cc-adds]="adds()"
     >
       <ng-template [cubeSquareTile]="tiles()" let-t let-level="level">
-        <div class="cc-cell">
+        <div class="cc-cell" [ccAttrs]="t.attrs">
           <button
             type="button"
             [class]="'cc-tile cc-l' + level"
@@ -3207,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