@adea-ai/ui 0.64.0 → 0.65.0

package/README.md

@@ -218,6 +218,56 @@ acceptance and each application's mounted chat journey remain separate gates.
 
 Apache-2.0.
 
+## Binary layout model checkpoint
+
+UI issue #22 extracts the existing attributed bb/Muxy Adea adaptation rather
+than introducing another layout tree. `createLayoutState`, `splitPane`,
+`movePane`, `closePane`, `undoClosePane`, `focusPane`, `swapPanes`,
+`resizeSplit`, `normalizeLayout` and the reading-order helpers are pure.
+Leaves extend `{kind: 'leaf', id: string}` with any host-owned payload. Closing
+the last leaf calls an injected placeholder factory; it never selects a harness,
+starts a terminal or deletes a project. Eight leaves/depth eight and 10–90%
+ratios preserve the accepted contract. Construct or validate a tree before
+editing it; the shared constructor validates visual structure and identities,
+while applications still decode/scoped-persist preferences and retain unknown
+future versions for recovery.
+
+The model and maintained accessible renderer are implemented in this draft.
+Stable content ownership and movement are exercised in component fixtures.
+The packed renderer gate includes the UI #20 size-token correction and the host
+presentation fixture. It checks the real package in compiled and Solid
+conditions; complete shell composition, production adoption and release remain
+required.
+No persistent state, session services, native drag region or host framework is
+imported into this model.
+
+### Host pane presentation hooks
+
+`SplitLayout` can keep its default pane header while allowing a host to supply
+inline visible content with `renderPaneLabel`, opt pane regions into keyboard
+Tab navigation with `paneTabIndex={0}`, and provide a domain-specific splitter
+name with `labelForSeparator`. Pane regions remain programmatically focusable
+by default (`paneTabIndex={-1}`), and separators keep their orientation-based
+names unless the host supplies a label.
+
+`renderPaneLabel` receives a stable `Accessor<L>` once for each leaf owner.
+Read `leaf()` inside the returned JSX so Solid tracks payload changes while the
+same pane owner is retained during split and move operations. This visible
+header content does not define the region's accessible name or the close
+button's name: both continue to come from `labelForLeaf`, so hosts should
+provide an accessible domain label there as well.
+
+The `HostPresentation` story shows a decorative icon and host title, keyboard
+pane stops, and a workspace-specific separator name. A narrow-width component
+fixture also checks that a long host title does not widen its pane header.
+
+`bun run check:packed-layout` packs the real artifact, installs it in a disposable
+consumer with peers omitted and scripts disabled, and exercises the direct model
+subpath in native Node and the Solid source condition. It verifies zero runtime
+imports and a 3 KiB gzip model budget (measured baseline: 2,455 bytes). This is
+model-subpath evidence; it does not waive UI #16's package attribution/conditional
+export corrections or the separate root compatibility gate.
+
 ### Controlled appearance editor
 
 `AppearanceEditor` and `AppearancePopover` retain the accepted Zeron-derived

package/dist/NOTICE

@@ -49,6 +49,65 @@ Origin UI / coss (AGPL-3.0-or-later) was consulted for visual ideas only. No
 code, class string, or asset from that project is reproduced here, because its
 licence is incompatible with this distribution.
 
+## Strict binary layout extracted from the accepted Adea donor port
+
+`packages/ui/src/components/layout/split-layout/model.ts` is extracted from
+Adea `packages/dev-view/src/layout/operations.ts` at
+`0322ab09ff5e9775bfddc0bf2d81e1df436dbef7`, whose MIT portions substantially
+translate bb `apps/app/src/lib/split-layout/ops.ts` at
+`52a9256373d4d36f9b60e9e2a7f333464091a2ac` and Muxy
+`Muxy/Models/Workspace/SplitNode.swift` at
+`5c5be8697c57a2fe70cda97fdbaf7c912e2e31b6`.
+
+Copyright (c) 2026 Michael Yong
+Copyright (c) 2026 Muxy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The accepted strict binary representation, reading-order insertion, parent
+collapse, exact leaf identity, resize/normalize, move-at-cap and undo semantics
+are retained. Opaque host leaves replace private domain types and the host
+supplies the last-pane placeholder. Construction validates visual identities
+and structural bounds; application scope/persistence, thread/runtime identity,
+harness launch and process authority are excluded. Nearest test behavior from
+Adea `packages/dev-view/tests/layout.test.ts` and bb `ops.test.ts` is preserved
+where it applies to the accepted binary model. The accessible renderer and
+application adoption remain separate gates under UI issue #22.
+
+### Binary frame renderer continuation
+
+`geometry.ts` translates `areaFrames` from the pinned Muxy source above. Its
+fractional frames, horizontal/vertical offsets and exact node references are
+retained; ratio repair uses the accepted 0.1–0.9 range rather than Muxy's 0–1.
+`split-layout.tsx` adapts the accepted Adea pane-header/close/focus behavior
+through generic callbacks, stable keyed leaf owners and Corvu separators.
+It excludes application commands, persistence, harness/thread authority and
+manual pointer listeners. This renderer is independently written against the
+accepted model; it is not a port of Muxy's native UI or an additional layout tree.
+The MIT attribution and permission above cover the translated frame algorithm.
+
+The pane-drag continuation retains Adea's nearest-edge placement ordering and
+pane-title gesture, replacing plaintext leaf IDs and string casts with typed
+intent, an instance-local active drag payload, and cancellation/removal checks.
+Header action composition injects application keyboard controls without owning
+shortcuts or domain transitions. No new upstream source or license is introduced.
+
 Busy composer action translated from KiroCrew
 --------------------------------------------
 Original: website/src/components/BusySendButton.tsx
@@ -71,7 +130,6 @@ action and unavailable reasons. No runtime queue or force-reset authority added.
 Nearest tests: BusySendButton.menuKeyboard.test.tsx and
 BusySendButton.slotScope.test.tsx; controlled mode replaces donor storage tests,
 while keyboard/focus expectations are exercised in Chromium and WebKit.
-
 ## Plain transcript follow translated from KiroCrew
 
 `packages/ui/src/components/conversation/scroll-follow-core.ts`,

package/dist/components/layout/split-layout/drop.d.ts

@@ -0,0 +1,13 @@
+import type { SplitLayoutBranch } from './model';
+export type PaneDropIntent = {
+    direction: SplitLayoutBranch['direction'];
+    placement: 'before' | 'after';
+};
+/** Accepted Adea closest-edge intent; invalid/outside geometry cannot authorize a move. */
+export declare function paneDropIntent(clientX: number, clientY: number, rect: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}): PaneDropIntent | undefined;
+//# sourceMappingURL=drop.d.ts.map

package/dist/components/layout/split-layout/drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/split-layout/drop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAA;IACzC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAA;CAC9B,CAAA;AACD,2FAA2F;AAC3F,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjE,cAAc,GAAG,SAAS,CAkB5B"}

package/dist/components/layout/split-layout/drop.js

@@ -0,0 +1,50 @@
+//#region src/components/layout/split-layout/drop.ts
+/** Accepted Adea closest-edge intent; invalid/outside geometry cannot authorize a move. */
+function paneDropIntent(clientX, clientY, rect) {
+	const { left, top, width, height } = rect;
+	if (![
+		clientX,
+		clientY,
+		left,
+		top,
+		width,
+		height
+	].every(Number.isFinite) || width <= 0 || height <= 0) return;
+	const x = clientX - left;
+	const y = clientY - top;
+	if (x < 0 || y < 0 || x > width || y > height) return;
+	return [
+		{
+			distance: x,
+			intent: {
+				direction: "row",
+				placement: "before"
+			}
+		},
+		{
+			distance: width - x,
+			intent: {
+				direction: "row",
+				placement: "after"
+			}
+		},
+		{
+			distance: y,
+			intent: {
+				direction: "column",
+				placement: "before"
+			}
+		},
+		{
+			distance: height - y,
+			intent: {
+				direction: "column",
+				placement: "after"
+			}
+		}
+	].reduce((best, next) => next.distance < best.distance ? next : best).intent;
+}
+//#endregion
+export { paneDropIntent };
+
+//# sourceMappingURL=drop.js.map

package/dist/components/layout/split-layout/drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.js","names":[],"sources":["../../../../src/components/layout/split-layout/drop.ts"],"sourcesContent":["import type { SplitLayoutBranch } from './model'\nexport type PaneDropIntent = {\n  direction: SplitLayoutBranch['direction']\n  placement: 'before' | 'after'\n}\n/** Accepted Adea closest-edge intent; invalid/outside geometry cannot authorize a move. */\nexport function paneDropIntent(\n  clientX: number,\n  clientY: number,\n  rect: { left: number; top: number; width: number; height: number }\n): PaneDropIntent | undefined {\n  const { left, top, width, height } = rect\n  if (\n    ![clientX, clientY, left, top, width, height].every(Number.isFinite) ||\n    width <= 0 ||\n    height <= 0\n  )\n    return\n  const x = clientX - left\n  const y = clientY - top\n  if (x < 0 || y < 0 || x > width || y > height) return\n  const candidates: { distance: number; intent: PaneDropIntent }[] = [\n    { distance: x, intent: { direction: 'row', placement: 'before' } },\n    { distance: width - x, intent: { direction: 'row', placement: 'after' } },\n    { distance: y, intent: { direction: 'column', placement: 'before' } },\n    { distance: height - y, intent: { direction: 'column', placement: 'after' } },\n  ]\n  return candidates.reduce((best, next) => (next.distance < best.distance ? next : best)).intent\n}\n"],"mappings":";;AAMA,SAAgB,eACd,SACA,SACA,MAC4B;CAC5B,MAAM,EAAE,MAAM,KAAK,OAAO,WAAW;CACrC,IACE,CAAC;EAAC;EAAS;EAAS;EAAM;EAAK;EAAO;CAAM,CAAC,CAAC,MAAM,OAAO,QAAQ,KACnE,SAAS,KACT,UAAU,GAEV;CACF,MAAM,IAAI,UAAU;CACpB,MAAM,IAAI,UAAU;CACpB,IAAI,IAAI,KAAK,IAAI,KAAK,IAAI,SAAS,IAAI,QAAQ;CAO/C,OAAO;EALL;GAAE,UAAU;GAAG,QAAQ;IAAE,WAAW;IAAO,WAAW;GAAS;EAAE;EACjE;GAAE,UAAU,QAAQ;GAAG,QAAQ;IAAE,WAAW;IAAO,WAAW;GAAQ;EAAE;EACxE;GAAE,UAAU;GAAG,QAAQ;IAAE,WAAW;IAAU,WAAW;GAAS;EAAE;EACpE;GAAE,UAAU,SAAS;GAAG,QAAQ;IAAE,WAAW;IAAU,WAAW;GAAQ;EAAE;CAEvE,CAAA,CAAW,QAAQ,MAAM,SAAU,KAAK,WAAW,KAAK,WAAW,OAAO,IAAK,CAAC,CAAC;AAC1F"}

package/dist/components/layout/split-layout/geometry.d.ts

@@ -0,0 +1,14 @@
+import { type SplitLayoutLeaf, type SplitLayoutNode } from './model';
+export type LayoutRect = Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+export type LayoutFrame<L extends SplitLayoutLeaf = SplitLayoutLeaf> = Readonly<{
+    node: SplitLayoutNode<L>;
+    rect: LayoutRect;
+}>;
+/** Stable leaf DOM can use these fractions without being reparented into a changing nested tree. */
+export declare function computeLayoutFrames<L extends SplitLayoutLeaf>(node: SplitLayoutNode<L>): ReadonlyMap<string, LayoutFrame<L>>;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/components/layout/split-layout/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/split-layout/geometry.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,SAAS,CAAA;AAChB,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAC1F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,QAAQ,CAAC;IAC9E,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,EAAE,UAAU,CAAA;CACjB,CAAC,CAAA;AACF,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAoBrC"}

package/dist/components/layout/split-layout/geometry.js

@@ -0,0 +1,44 @@
+import { MAX_SPLIT_RATIO, MIN_SPLIT_RATIO } from "./model.js";
+//#region src/components/layout/split-layout/geometry.ts
+/** Stable leaf DOM can use these fractions without being reparented into a changing nested tree. */
+function computeLayoutFrames(node) {
+	const frames = /* @__PURE__ */ new Map();
+	const visit = (current, rect) => {
+		frames.set(current.id, {
+			node: current,
+			rect
+		});
+		if (current.kind === "leaf") return;
+		const ratio = Number.isFinite(current.ratio) ? Math.min(MAX_SPLIT_RATIO, Math.max(MIN_SPLIT_RATIO, current.ratio)) : .5;
+		const row = current.direction === "row";
+		const first = row ? {
+			...rect,
+			width: rect.width * ratio
+		} : {
+			...rect,
+			height: rect.height * ratio
+		};
+		const second = row ? {
+			...rect,
+			x: rect.x + first.width,
+			width: rect.width - first.width
+		} : {
+			...rect,
+			y: rect.y + first.height,
+			height: rect.height - first.height
+		};
+		visit(current.children[0], first);
+		visit(current.children[1], second);
+	};
+	visit(node, {
+		x: 0,
+		y: 0,
+		width: 1,
+		height: 1
+	});
+	return frames;
+}
+//#endregion
+export { computeLayoutFrames };
+
+//# sourceMappingURL=geometry.js.map

package/dist/components/layout/split-layout/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","names":[],"sources":["../../../../src/components/layout/split-layout/geometry.ts"],"sourcesContent":["/*\n * Translated from Muxy/Models/Workspace/SplitNode.swift areaFrames at\n * 5c5be8697c57a2fe70cda97fdbaf7c912e2e31b6.\n * Copyright (c) 2026 Muxy. SPDX-License-Identifier: MIT. See NOTICE.\n */\nimport {\n  MAX_SPLIT_RATIO,\n  MIN_SPLIT_RATIO,\n  type SplitLayoutLeaf,\n  type SplitLayoutNode,\n} from './model'\nexport type LayoutRect = Readonly<{ x: number; y: number; width: number; height: number }>\nexport type LayoutFrame<L extends SplitLayoutLeaf = SplitLayoutLeaf> = Readonly<{\n  node: SplitLayoutNode<L>\n  rect: LayoutRect\n}>\n/** Stable leaf DOM can use these fractions without being reparented into a changing nested tree. */\nexport function computeLayoutFrames<L extends SplitLayoutLeaf>(\n  node: SplitLayoutNode<L>\n): ReadonlyMap<string, LayoutFrame<L>> {\n  const frames = new Map<string, LayoutFrame<L>>()\n  const visit = (current: SplitLayoutNode<L>, rect: LayoutRect) => {\n    frames.set(current.id, { node: current, rect })\n    if (current.kind === 'leaf') return\n    const ratio = Number.isFinite(current.ratio)\n      ? Math.min(MAX_SPLIT_RATIO, Math.max(MIN_SPLIT_RATIO, current.ratio))\n      : 0.5\n    const row = current.direction === 'row'\n    const first = row\n      ? { ...rect, width: rect.width * ratio }\n      : { ...rect, height: rect.height * ratio }\n    const second = row\n      ? { ...rect, x: rect.x + first.width, width: rect.width - first.width }\n      : { ...rect, y: rect.y + first.height, height: rect.height - first.height }\n    visit(current.children[0], first)\n    visit(current.children[1], second)\n  }\n  visit(node, { x: 0, y: 0, width: 1, height: 1 })\n  return frames\n}\n"],"mappings":";;;AAiBA,SAAgB,oBACd,MACqC;CACrC,MAAM,yBAAS,IAAI,IAA4B;CAC/C,MAAM,SAAS,SAA6B,SAAqB;EAC/D,OAAO,IAAI,QAAQ,IAAI;GAAE,MAAM;GAAS;EAAK,CAAC;EAC9C,IAAI,QAAQ,SAAS,QAAQ;EAC7B,MAAM,QAAQ,OAAO,SAAS,QAAQ,KAAK,IACvC,KAAK,IAAI,iBAAiB,KAAK,IAAI,iBAAiB,QAAQ,KAAK,CAAC,IAClE;EACJ,MAAM,MAAM,QAAQ,cAAc;EAClC,MAAM,QAAQ,MACV;GAAE,GAAG;GAAM,OAAO,KAAK,QAAQ;EAAM,IACrC;GAAE,GAAG;GAAM,QAAQ,KAAK,SAAS;EAAM;EAC3C,MAAM,SAAS,MACX;GAAE,GAAG;GAAM,GAAG,KAAK,IAAI,MAAM;GAAO,OAAO,KAAK,QAAQ,MAAM;EAAM,IACpE;GAAE,GAAG;GAAM,GAAG,KAAK,IAAI,MAAM;GAAQ,QAAQ,KAAK,SAAS,MAAM;EAAO;EAC5E,MAAM,QAAQ,SAAS,IAAI,KAAK;EAChC,MAAM,QAAQ,SAAS,IAAI,MAAM;CACnC;CACA,MAAM,MAAM;EAAE,GAAG;EAAG,GAAG;EAAG,OAAO;EAAG,QAAQ;CAAE,CAAC;CAC/C,OAAO;AACT"}

package/dist/components/layout/split-layout/index.d.ts

@@ -0,0 +1,5 @@
+/** Issue-backed binary layout with stable opaque leaf owners; scoped persistence belongs to the host. */
+export * from './model';
+export * from './geometry';
+export * from './split-layout';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/layout/split-layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/split-layout/index.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/components/layout/split-layout/index.js

@@ -0,0 +1,4 @@
+import { MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, closePane, countLeaves, createLayoutState, focusPane, layoutDepth, listLeaves, movePane, neighborLeaf, normalizeLayout, resizeSplit, splitPane, swapPanes, undoClosePane } from "./model.js";
+import { computeLayoutFrames } from "./geometry.js";
+import { SplitLayout } from "./split-layout.js";
+export { MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, SplitLayout, closePane, computeLayoutFrames, countLeaves, createLayoutState, focusPane, layoutDepth, listLeaves, movePane, neighborLeaf, normalizeLayout, resizeSplit, splitPane, swapPanes, undoClosePane };

package/dist/components/layout/split-layout/model.d.ts

@@ -0,0 +1,51 @@
+/** A visual identity only. Extend this with host-owned payload; UI never interprets it. */
+export type SplitLayoutLeaf = Readonly<{
+    kind: 'leaf';
+    id: string;
+}>;
+export type SplitLayoutBranch<L extends SplitLayoutLeaf = SplitLayoutLeaf> = Readonly<{
+    kind: 'split';
+    id: string;
+    direction: 'row' | 'column';
+    ratio: number;
+    children: readonly [SplitLayoutNode<L>, SplitLayoutNode<L>];
+}>;
+export type SplitLayoutNode<L extends SplitLayoutLeaf = SplitLayoutLeaf> = L | SplitLayoutBranch<L>;
+export declare const MAX_LAYOUT_LEAVES = 8;
+export declare const MAX_LAYOUT_DEPTH = 8;
+export declare const MIN_SPLIT_RATIO = 0.1;
+export declare const MAX_SPLIT_RATIO = 0.9;
+export type SplitLayoutState<L extends SplitLayoutLeaf = SplitLayoutLeaf> = Readonly<{
+    center: SplitLayoutNode<L>;
+    focusedLeafId: string;
+    closed: readonly Readonly<{
+        center: SplitLayoutNode<L>;
+        leafId: string;
+    }>[];
+}>;
+export type SplitPaneInput<L extends SplitLayoutLeaf = SplitLayoutLeaf> = Readonly<{
+    direction: SplitLayoutBranch<L>['direction'];
+    placement: 'before' | 'after';
+    leaf: L;
+    splitId: string;
+}>;
+export declare function listLeaves<L extends SplitLayoutLeaf>(node: SplitLayoutNode<L>): readonly L[];
+export declare function countLeaves<L extends SplitLayoutLeaf>(node: SplitLayoutNode<L>): number;
+export declare function layoutDepth<L extends SplitLayoutLeaf>(node: SplitLayoutNode<L>): number;
+export declare function createLayoutState<L extends SplitLayoutLeaf>(center: SplitLayoutNode<L>): SplitLayoutState<L>;
+export declare function splitPane<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, targetLeafId: string, input: SplitPaneInput<L>): SplitLayoutState<L>;
+export declare function closePane<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, leafId: string, createPlaceholderLeaf: () => L): SplitLayoutState<L>;
+export declare function undoClosePane<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>): SplitLayoutState<L>;
+export declare function focusPane<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, leafId: string): SplitLayoutState<L>;
+export declare function swapPanes<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, firstLeafId: string, secondLeafId: string): SplitLayoutState<L>;
+export declare function movePane<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, leafId: string, targetLeafId: string, placement: 'before' | 'after', direction: SplitLayoutBranch<L>['direction'], splitId: string): SplitLayoutState<L>;
+export declare function resizeSplit<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, splitId: string, ratio: number): SplitLayoutState<L>;
+/**
+ * Pure repair walk ported from bb's size normalization: every split ratio is
+ * clamped into the normative range and a non-finite ratio falls back to an
+ * even split. Structure, IDs, and focus are untouched.
+ */
+export declare function normalizeLayout<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>): SplitLayoutState<L>;
+/** The leaf immediately after (`1`) or before (`-1`) the given leaf in reading order. */
+export declare function neighborLeaf<L extends SplitLayoutLeaf>(state: SplitLayoutState<L>, leafId: string, step: 1 | -1): L | undefined;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/layout/split-layout/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/split-layout/model.ts"],"names":[],"mappings":"AAiBA,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AACpE,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,QAAQ,CAAC;IACpF,IAAI,EAAE,OAAO,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;CAC5D,CAAC,CAAA;AACF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAA;AAEnG,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,eAAO,MAAM,eAAe,MAAM,CAAA;AAClC,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,QAAQ,CAAC;IACnF,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,SAAS,QAAQ,CAAC;QAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;CAC5E,CAAC,CAAA;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,QAAQ,CAAC;IACjF,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAC5C,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAA;IAC7B,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,MAAM,CAAA;CAChB,CAAC,CAAA;AAEF,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAI5F;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAEvF;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAIvF;AA0FD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,eAAe,EACzD,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,gBAAgB,CAAC,CAAC,CAAC,CAKrB;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,EACjD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GACvB,gBAAgB,CAAC,CAAC,CAAC,CAmBrB;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,EACjD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,EACd,qBAAqB,EAAE,MAAM,CAAC,GAC7B,gBAAgB,CAAC,CAAC,CAAC,CAmBrB;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EACrD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACzB,gBAAgB,CAAC,CAAC,CAAC,CAQrB;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,EACjD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,GACb,gBAAgB,CAAC,CAAC,CAAC,CAIrB;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,EACjD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAAC,CAAC,CAAC,CAmBrB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,eAAe,EAChD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,QAAQ,GAAG,OAAO,EAC7B,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAC5C,OAAO,EAAE,MAAM,GACd,gBAAgB,CAAC,CAAC,CAAC,CAYrB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EACnD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAAC,CAAC,CAAC,CAkBrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,eAAe,EACvD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACzB,gBAAgB,CAAC,CAAC,CAAC,CAgBrB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,SAAS,eAAe,EACpD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GACX,CAAC,GAAG,SAAS,CAKf"}

package/dist/components/layout/split-layout/model.js

@@ -0,0 +1,255 @@
+//#region src/components/layout/split-layout/model.ts
+var MAX_LAYOUT_LEAVES = 8;
+var MAX_LAYOUT_DEPTH = 8;
+var MIN_SPLIT_RATIO = .1;
+var MAX_SPLIT_RATIO = .9;
+function listLeaves(node) {
+	return node.kind === "leaf" ? [node] : [...listLeaves(node.children[0]), ...listLeaves(node.children[1])];
+}
+function countLeaves(node) {
+	return node.kind === "leaf" ? 1 : countLeaves(node.children[0]) + countLeaves(node.children[1]);
+}
+function layoutDepth(node) {
+	return node.kind === "leaf" ? 1 : 1 + Math.max(layoutDepth(node.children[0]), layoutDepth(node.children[1]));
+}
+function replaceLeaf(node, leafId, replacement) {
+	if (node.kind === "leaf") return node.id === leafId ? replacement : node;
+	const first = replaceLeaf(node.children[0], leafId, replacement);
+	const second = replaceLeaf(node.children[1], leafId, replacement);
+	return first === node.children[0] && second === node.children[1] ? node : {
+		...node,
+		children: [first, second]
+	};
+}
+function removeLeaf(node, leafId) {
+	if (node.kind === "leaf") return node.id === leafId ? null : node;
+	const first = removeLeaf(node.children[0], leafId);
+	const second = removeLeaf(node.children[1], leafId);
+	if (!first) return second;
+	if (!second) return first;
+	return first === node.children[0] && second === node.children[1] ? node : {
+		...node,
+		children: [first, second]
+	};
+}
+function containsLeaf(node, leafId) {
+	return node.kind === "leaf" ? node.id === leafId : containsLeaf(node.children[0], leafId) || containsLeaf(node.children[1], leafId);
+}
+function assertUniqueInput(state, leaf, splitId) {
+	assertLayoutTree(leaf);
+	if (typeof splitId !== "string" || splitId.length === 0) throw new Error("invalid_state: split identity must be nonempty");
+	const ids = /* @__PURE__ */ new Set();
+	const visit = (node) => {
+		if (ids.has(node.id)) throw new Error("invalid_state: duplicate pane id");
+		ids.add(node.id);
+		if (node.kind === "split") node.children.forEach(visit);
+	};
+	visit(state.center);
+	if (ids.has(leaf.id) || ids.has(splitId) || leaf.id === splitId) throw new Error("invalid_state: duplicate pane id");
+}
+/** Visual-tree validation only; applications still decode and scope persisted preferences. */
+function assertLayoutTree(center) {
+	const ids = /* @__PURE__ */ new Set();
+	const seen = /* @__PURE__ */ new WeakSet();
+	let leaves = 0;
+	const visit = (node, depth) => {
+		if (depth > 8) throw new Error("limit_exceeded: layout depth exceeds eight");
+		if (!node || typeof node !== "object") throw new Error("invalid_state: missing layout node");
+		if (seen.has(node)) throw new Error("invalid_state: cyclic or reused layout node");
+		seen.add(node);
+		if (typeof node.id !== "string" || node.id.length === 0) throw new Error("invalid_state: layout identity must be nonempty");
+		if (ids.has(node.id)) throw new Error("invalid_state: duplicate pane id");
+		ids.add(node.id);
+		if (node.kind === "leaf") {
+			leaves += 1;
+			if (leaves > 8) throw new Error("limit_exceeded: layout has more than eight leaves");
+			return;
+		}
+		if (node.kind !== "split" || !Array.isArray(node.children) || node.children.length !== 2 || node.direction !== "row" && node.direction !== "column") throw new Error("invalid_state: layout must be a strict binary row or column tree");
+		visit(node.children[0], depth + 1);
+		visit(node.children[1], depth + 1);
+	};
+	visit(center, 1);
+}
+function createLayoutState(center) {
+	assertLayoutTree(center);
+	const first = listLeaves(center)[0];
+	if (!first) throw new Error("invalid_state: layout requires a leaf");
+	return {
+		center,
+		focusedLeafId: first.id,
+		closed: []
+	};
+}
+function splitPane(state, targetLeafId, input) {
+	if (!containsLeaf(state.center, targetLeafId)) return state;
+	if (countLeaves(state.center) >= 8) throw new Error("limit_exceeded: center layout has eight leaves");
+	assertUniqueInput(state, input.leaf, input.splitId);
+	const target = listLeaves(state.center).find((leaf) => leaf.id === targetLeafId);
+	if (!target) return state;
+	const children = input.placement === "before" ? [input.leaf, target] : [target, input.leaf];
+	const center = replaceLeaf(state.center, targetLeafId, {
+		kind: "split",
+		id: input.splitId,
+		direction: input.direction,
+		ratio: .5,
+		children
+	});
+	if (layoutDepth(center) > 8) throw new Error("limit_exceeded: center layout depth exceeds eight");
+	return {
+		...state,
+		center,
+		focusedLeafId: input.leaf.id,
+		closed: []
+	};
+}
+function closePane(state, leafId, createPlaceholderLeaf) {
+	if (!containsLeaf(state.center, leafId)) return state;
+	const before = state.center;
+	const closedIndex = listLeaves(before).findIndex((leaf) => leaf.id === leafId);
+	const removed = removeLeaf(before, leafId);
+	const center = removed ?? createPlaceholderLeaf();
+	if (!removed) {
+		if (center.kind !== "leaf") throw new Error("invalid_state: placeholder must be a leaf");
+		assertLayoutTree(center);
+	}
+	const leaves = listLeaves(center);
+	const fallback = leaves[Math.min(closedIndex, leaves.length - 1)] ?? leaves[0];
+	if (!fallback) throw new Error("invalid_state: layout requires a leaf");
+	return {
+		center,
+		focusedLeafId: state.focusedLeafId === leafId ? fallback.id : state.focusedLeafId,
+		closed: [...state.closed, {
+			center: before,
+			leafId
+		}]
+	};
+}
+function undoClosePane(state) {
+	const previous = state.closed.at(-1);
+	if (!previous) return state;
+	return {
+		center: previous.center,
+		focusedLeafId: previous.leafId,
+		closed: state.closed.slice(0, -1)
+	};
+}
+function focusPane(state, leafId) {
+	return containsLeaf(state.center, leafId) && state.focusedLeafId !== leafId ? {
+		...state,
+		focusedLeafId: leafId
+	} : state;
+}
+function swapPanes(state, firstLeafId, secondLeafId) {
+	if (firstLeafId === secondLeafId) return state;
+	const leaves = listLeaves(state.center);
+	const first = leaves.find((leaf) => leaf.id === firstLeafId);
+	const second = leaves.find((leaf) => leaf.id === secondLeafId);
+	if (!first || !second) return state;
+	const swap = (node) => {
+		if (node.kind === "leaf") {
+			if (node.id === firstLeafId) return second;
+			if (node.id === secondLeafId) return first;
+			return node;
+		}
+		const left = swap(node.children[0]);
+		const right = swap(node.children[1]);
+		return left === node.children[0] && right === node.children[1] ? node : {
+			...node,
+			children: [left, right]
+		};
+	};
+	return {
+		...state,
+		center: swap(state.center),
+		closed: []
+	};
+}
+function movePane(state, leafId, targetLeafId, placement, direction, splitId) {
+	if (leafId === targetLeafId) return state;
+	const moving = listLeaves(state.center).find((leaf) => leaf.id === leafId);
+	if (!moving || !containsLeaf(state.center, targetLeafId)) return state;
+	const detached = removeLeaf(state.center, leafId);
+	if (!detached) return state;
+	return {
+		...splitPane({
+			center: detached,
+			focusedLeafId: state.focusedLeafId,
+			closed: state.closed
+		}, targetLeafId, {
+			direction,
+			placement,
+			leaf: moving,
+			splitId
+		}),
+		focusedLeafId: leafId
+	};
+}
+function resizeSplit(state, splitId, ratio) {
+	if (!Number.isFinite(ratio)) return state;
+	const nextRatio = Math.min(MAX_SPLIT_RATIO, Math.max(MIN_SPLIT_RATIO, ratio));
+	let found = false;
+	const visit = (node) => {
+		if (node.kind === "leaf") return node;
+		if (node.id === splitId) {
+			found = true;
+			return node.ratio === nextRatio ? node : {
+				...node,
+				ratio: nextRatio
+			};
+		}
+		const first = visit(node.children[0]);
+		const second = visit(node.children[1]);
+		return first === node.children[0] && second === node.children[1] ? node : {
+			...node,
+			children: [first, second]
+		};
+	};
+	const center = visit(state.center);
+	return found && center !== state.center ? {
+		...state,
+		center,
+		closed: []
+	} : state;
+}
+/**
+* Pure repair walk ported from bb's size normalization: every split ratio is
+* clamped into the normative range and a non-finite ratio falls back to an
+* even split. Structure, IDs, and focus are untouched.
+*/
+function normalizeLayout(state) {
+	const visit = (node) => {
+		if (node.kind === "leaf") return {
+			node,
+			changed: false
+		};
+		const first = visit(node.children[0]);
+		const second = visit(node.children[1]);
+		const ratio = Number.isFinite(node.ratio) ? Math.min(MAX_SPLIT_RATIO, Math.max(MIN_SPLIT_RATIO, node.ratio)) : 1 / 2;
+		const changed = first.changed || second.changed || ratio !== node.ratio;
+		return {
+			node: changed ? {
+				...node,
+				ratio,
+				children: [first.node, second.node]
+			} : node,
+			changed
+		};
+	};
+	const result = visit(state.center);
+	return result.changed ? {
+		...state,
+		center: result.node
+	} : state;
+}
+/** The leaf immediately after (`1`) or before (`-1`) the given leaf in reading order. */
+function neighborLeaf(state, leafId, step) {
+	const leaves = listLeaves(state.center);
+	const index = leaves.findIndex((leaf) => leaf.id === leafId);
+	if (index < 0) return void 0;
+	return leaves[index + step];
+}
+//#endregion
+export { MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, closePane, countLeaves, createLayoutState, focusPane, layoutDepth, listLeaves, movePane, neighborLeaf, normalizeLayout, resizeSplit, splitPane, swapPanes, undoClosePane };
+
+//# sourceMappingURL=model.js.map