@embedpdf/react 3.0.0-next.14 → 3.0.0-next.15

package/dist/toolbar.cjs

@@ -1,62 +1,48 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
-const require_runtime = require("./runtime.cjs");
+const require_runtime = require("./runtime-fzpGv78v.cjs");
+const require_inert = require("./inert-CmBEbKCn.cjs");
 let react_jsx_runtime = require("react/jsx-runtime");
+let _embedpdf_web = require("@embedpdf/web");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react, 1);
 let _embedpdf_core_ui = require("@embedpdf/core-ui");
+let _embedpdf_plugin_commands_contract_host = require("@embedpdf/plugin-commands/contract/host");
 let _embedpdf_plugin_commands_contract = require("@embedpdf/plugin-commands/contract");
 //#region src/toolbar.tsx
-const stripGroupsEqual = (a, b) => a.length === b.length && a.every((g, i) => g.id === b[i].id && g.commands.length === b[i].commands.length && g.commands.every((c, j) => (0, _embedpdf_plugin_commands_contract.resolvedCommandsEqual)(c, b[i].commands[j])));
+const stripGroupsEqual = (left, right) => (0, _embedpdf_core_ui.sameStripGroups)(left, right, _embedpdf_plugin_commands_contract.resolvedCommandsEqual);
 const NO_STRIP_GROUPS = [];
 /**
 * The live projection of a bar through the command registry — <Toolbar>'s
-* un-measured sibling, for contextual strips (ChromeSchema.strips). The schema
-* declares what COULD appear; each command's `visible` derivation decides what
-* DOES; null means nothing currently applies, so `if (!view) return null` is
+* un-measured sibling, for contextual strips (a bar over a selection). The schema
+* declares what could appear; each command's `visible` derivation decides what
+* does; null means nothing currently applies, so `if (!view) return null` is
 * the caller's entire show/hide logic. `execute` is pre-bound to this
 * subtree's document. Reads are value-equal (resolvedCommandsEqual), so
 * consumers re-render on real change, not on every store action.
 */
 function useStripView(bar) {
-	const commands = require_runtime.useCapability(_embedpdf_plugin_commands_contract.CommandsToken);
+	const commands = require_runtime.useCapability(_embedpdf_plugin_commands_contract_host.CommandsToken);
 	const documentId = require_runtime.useDocumentId();
 	const normalized = (0, react.useMemo)(() => bar ? (0, _embedpdf_core_ui.normalizeBar)(bar) : null, [bar]);
-	const groups = require_runtime.useKernelValue(() => {
-		if (!normalized) return NO_STRIP_GROUPS;
-		const resolved = /* @__PURE__ */ new Map();
-		const visible = (id) => {
-			const cmd = commands.resolve(id, documentId ?? void 0);
-			if (cmd) resolved.set(id, cmd);
-			return cmd?.visible === true;
-		};
-		return (0, _embedpdf_core_ui.projectStrip)(normalized, visible).map((g) => ({
-			id: g.id,
-			labelKey: g.labelKey,
-			commands: g.commands.map((id) => resolved.get(id))
-		}));
-	}, stripGroupsEqual);
+	const groups = require_runtime.useKernelValue(() => normalized ? (0, _embedpdf_core_ui.stripGroupsOf)(normalized, (id) => commands.resolveCommand(id, documentId ?? void 0)) : NO_STRIP_GROUPS, stripGroupsEqual);
 	return (0, react.useMemo)(() => groups.length === 0 ? null : {
 		groups,
-		execute: (id) => commands.execute(id, documentId ?? void 0)
+		execute: (id) => void commands.execute(id, { documentId: documentId ?? void 0 })
 	}, [
 		groups,
 		commands,
 		documentId
 	]);
 }
-/** Report this node's border-box width under `k`, live, via ResizeObserver. */
-function Measured({ k, onWidth, children }) {
+/** Report this node's border-box length along the toolbar under `k`, live. */
+function Measured({ k, orientation, onLength, children }) {
 	const ref = (0, react.useRef)(null);
-	(0, react.useLayoutEffect)(() => {
-		const el = ref.current;
-		if (!el) return;
-		const report = () => onWidth(k, el.getBoundingClientRect().width);
-		report();
-		const observer = new ResizeObserver(report);
-		observer.observe(el);
-		return () => observer.disconnect();
-	}, [k, onWidth]);
+	(0, react.useLayoutEffect)(() => ref.current ? (0, _embedpdf_web.observeLength)(ref.current, orientation, (length) => onLength(k, length)) : void 0, [
+		k,
+		orientation,
+		onLength
+	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 		ref,
 		style: {
@@ -70,20 +56,16 @@ function Measured({ k, onWidth, children }) {
 * The socket for an unregistered custom unit: a real `<slot>` element. Inside
 * the <embedpdf-viewer> shadow root the browser projects same-named light-DOM
 * children into it; anywhere else it just displays its fallback (the terminal
-* command). Measured live — the projected content lives in the HOST's world,
-* so its width can only be observed where it actually renders.
+* command). Measured live — the projected content lives in the host's world,
+* so its length can only be observed where it actually renders.
 */
-function NativeSlotSocket({ name, k, onWidth, children }) {
+function NativeSlotSocket({ name, k, orientation, onLength, children }) {
 	const ref = (0, react.useRef)(null);
-	(0, react.useLayoutEffect)(() => {
-		const el = ref.current;
-		if (!el) return;
-		const report = () => onWidth(k, el.getBoundingClientRect().width);
-		report();
-		const observer = new ResizeObserver(report);
-		observer.observe(el);
-		return () => observer.disconnect();
-	}, [k, onWidth]);
+	(0, react.useLayoutEffect)(() => ref.current ? (0, _embedpdf_web.observeLength)(ref.current, orientation, (length) => onLength(k, length)) : void 0, [
+		k,
+		orientation,
+		onLength
+	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("slot", {
 		ref,
 		name,
@@ -95,7 +77,13 @@ function NativeSlotSocket({ name, k, onWidth, children }) {
 		children
 	});
 }
-const measureLayerStyle = {
+/**
+* The hidden measurement layer: a row for a horizontal toolbar, a column for a
+* vertical one, and no height either way, so it never adds to the page. A
+* column keeps each item at its own width, so no text wraps and changes the
+* heights it reports.
+*/
+const measureLayerStyle = (orientation) => ({
 	position: "absolute",
 	left: 0,
 	top: 0,
@@ -104,9 +92,20 @@ const measureLayerStyle = {
 	visibility: "hidden",
 	pointerEvents: "none",
 	display: "flex",
-	whiteSpace: "nowrap"
-};
-const defaultRenderCommand = (cmd, variant, run) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+	whiteSpace: "nowrap",
+	...orientation === "vertical" ? {
+		flexDirection: "column",
+		alignItems: "flex-start"
+	} : null
+});
+/** Marks the element around each item of the live row: its first focusable element is a stop. */
+const TOOLBAR_ITEM = { [_embedpdf_web.TOOLBAR_ITEM_ATTRIBUTE]: "" };
+/** The element around an item adds no box, so the item lays out as the section's own child. */
+const ITEM_STYLE = { display: "contents" };
+const SURFACE = (0, _embedpdf_web.paintDefault)("toolbar-surface");
+const BORDER = (0, _embedpdf_web.paintDefault)("toolbar-border");
+const ACTIVE = (0, _embedpdf_web.paintDefault)("toolbar-active");
+const defaultRenderCommand = (cmd, _variant, run) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 	type: "button",
 	onClick: run,
 	disabled: !cmd.enabled,
@@ -119,20 +118,25 @@ const defaultRenderCommand = (cmd, variant, run) => /* @__PURE__ */ (0, react_js
 		gap: 4,
 		padding: "4px 8px",
 		whiteSpace: "nowrap",
-		background: cmd.active ? "rgba(0,0,0,0.12)" : "transparent",
-		border: "1px solid rgba(0,0,0,0.15)",
+		color: "inherit",
+		font: "inherit",
+		background: cmd.active ? ACTIVE : "transparent",
+		border: `1px solid ${BORDER}`,
 		borderRadius: 4,
 		cursor: cmd.enabled ? "pointer" : "default",
 		opacity: cmd.enabled ? 1 : .4
 	},
-	children: [variant === "label" ? cmd.label : cmd.icon ?? cmd.label, variant === "icon+label" ? ` ${cmd.label}` : null]
+	children: cmd.label
 });
-const defaultRenderSeparator = () => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { style: {
-	width: 1,
-	alignSelf: "stretch",
-	background: "currentColor",
-	opacity: .2
-} });
+/** A 1px line across the toolbar: upright in a horizontal one, flat in a vertical one. */
+function DefaultSeparator({ orientation }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { style: {
+		...orientation === "vertical" ? { height: 1 } : { width: 1 },
+		alignSelf: "stretch",
+		background: "currentColor",
+		opacity: .2
+	} });
+}
 const defaultRenderOverflowTrigger = (isOpen, toggle) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 	type: "button",
 	onClick: toggle,
@@ -143,39 +147,64 @@ const defaultRenderOverflowTrigger = (isOpen, toggle) => /* @__PURE__ */ (0, rea
 		display: "inline-flex",
 		alignItems: "center",
 		padding: "4px 8px",
-		border: "1px solid rgba(0,0,0,0.15)",
+		color: "inherit",
+		font: "inherit",
+		border: `1px solid ${BORDER}`,
 		borderRadius: 4,
-		background: isOpen ? "rgba(0,0,0,0.12)" : "transparent",
+		background: isOpen ? ACTIVE : "transparent",
 		cursor: "pointer"
 	},
 	children: "⋯"
 });
-function DefaultOverflowMenu({ view }) {
+/** Where a default menu opens: under a horizontal toolbar's button, beside a vertical one's. */
+const menuPlacement = (orientation) => orientation === "vertical" ? {
+	top: 0,
+	insetInlineStart: "100%"
+} : {
+	top: "100%",
+	insetInlineEnd: 0
+};
+/**
+* The default menu, opened by the button beside it in the same parent: it
+* closes on a press outside that parent, and takes the menu keys while open.
+*/
+function DefaultOverflowMenu({ view, orientation }) {
+	const menu = (0, react.useRef)(null);
+	const close = (0, react.useRef)(view.close);
+	close.current = view.close;
+	(0, react.useLayoutEffect)(() => {
+		const element = menu.current;
+		if (!view.isOpen || !element) return;
+		const container = element.parentElement ?? element;
+		const trigger = (0, _embedpdf_web.focusablesIn)(container).find((candidate) => !element.contains(candidate)) ?? null;
+		const stopOutside = (0, _embedpdf_web.observeOutsidePress)(container, () => close.current());
+		const detachKeys = (0, _embedpdf_web.attachMenuKeys)(element, {
+			trigger,
+			close: () => close.current()
+		});
+		return () => {
+			stopOutside();
+			detachKeys();
+		};
+	}, [view.isOpen]);
 	if (!view.isOpen) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		style: {
-			position: "fixed",
-			inset: 0,
-			zIndex: 40
-		},
-		onClick: view.close
-	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		ref: menu,
 		role: "menu",
 		style: {
 			position: "absolute",
-			right: 0,
-			top: "100%",
+			...menuPlacement(orientation),
 			zIndex: 41,
 			minWidth: 200,
 			padding: 4,
-			background: "white",
-			border: "1px solid rgba(0,0,0,0.15)",
+			background: SURFACE,
+			border: `1px solid ${BORDER}`,
 			borderRadius: 6,
 			boxShadow: "0 4px 16px rgba(0,0,0,0.15)"
 		},
 		children: view.sections.map((section, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [i > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { style: {
 			height: 1,
-			background: "rgba(0,0,0,0.1)",
+			background: BORDER,
 			margin: "4px 0"
 		} }), section.rows.map((row) => {
 			const cmd = view.resolve(row.command);
@@ -186,6 +215,7 @@ function DefaultOverflowMenu({ view }) {
 				role: section.role === "radio" ? "menuitemradio" : "menuitem",
 				"aria-checked": section.role === "radio" ? cmd.active : void 0,
 				disabled: !cmd.enabled,
+				tabIndex: -1,
 				onClick: () => {
 					view.execute(row.command);
 					if (!isSubmenu) view.close();
@@ -198,6 +228,8 @@ function DefaultOverflowMenu({ view }) {
 					gap: 16,
 					padding: "6px 8px",
 					border: "none",
+					color: "inherit",
+					font: "inherit",
 					background: "transparent",
 					cursor: cmd.enabled ? "pointer" : "default",
 					opacity: cmd.enabled ? 1 : .4,
@@ -206,61 +238,48 @@ function DefaultOverflowMenu({ view }) {
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [cmd.active && section.role === "radio" ? "• " : "", cmd.label] }), isSubmenu ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "▸" }) : null]
 			}, row.command);
 		})] }, i))
-	})] });
+	});
 }
-function DefaultCollapsed({ view }) {
+function DefaultCollapsed({ view, orientation }) {
 	if (view.collapse === "select") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
-		value: view.commands.find((c) => c.active)?.id ?? "",
-		onChange: (e) => view.execute(e.target.value),
+		value: view.commands.find((command) => command.active)?.id ?? "",
+		onChange: (event) => view.execute(event.target.value),
 		style: {
 			padding: "4px 6px",
-			borderRadius: 4
+			font: "inherit",
+			borderRadius: 4,
+			border: `1px solid ${BORDER}`,
+			background: SURFACE
 		},
-		children: view.commands.map((c) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-			value: c.id,
-			disabled: !c.enabled,
-			children: c.label
-		}, c.id))
+		children: view.commands.map((command) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+			value: command.id,
+			disabled: !command.enabled,
+			children: command.label
+		}, command.id))
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollapsedMenuButton, {
+		view,
+		orientation
 	});
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollapsedMenuButton, { view });
 }
-function CollapsedMenuButton({ view }) {
+function CollapsedMenuButton({ view, orientation }) {
 	const [isOpen, setOpen] = (0, react.useState)(false);
-	const sections = [{
-		labelKey: view.labelKey,
-		role: view.role === "tabs" ? "radio" : void 0,
-		rows: view.commands.map((c) => ({
-			type: "command",
-			command: c.id
-		}))
-	}];
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 		style: {
 			position: "relative",
 			display: "inline-flex"
 		},
-		children: [defaultRenderOverflowTrigger(isOpen, () => setOpen((o) => !o)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultOverflowMenu, { view: {
-			sections,
-			isOpen,
-			close: () => setOpen(false),
-			resolve: (id) => view.commands.find((c) => c.id === id) ?? null,
-			execute: view.execute
-		} })]
+		children: [defaultRenderOverflowTrigger(isOpen, () => setOpen((previous) => !previous)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultOverflowMenu, {
+			view: (0, _embedpdf_core_ui.groupMenuView)(view, isOpen, () => setOpen(false)),
+			orientation
+		})]
 	});
 }
 /** Default shed-group disclosure: a chevron opening a radio menu of the
-*  hidden children — v2's overflow-tabs-button, derived. */
-function DefaultGroupTrigger({ view }) {
+*  hidden children. */
+function DefaultGroupTrigger({ view, orientation }) {
 	const [isOpen, setOpen] = (0, react.useState)(false);
-	const someActive = view.commands.some((c) => c.active);
-	const sections = [{
-		labelKey: view.labelKey,
-		role: view.role === "tabs" ? "radio" : void 0,
-		rows: view.commands.map((c) => ({
-			type: "command",
-			command: c.id
-		}))
-	}];
+	const someActive = view.commands.some((command) => command.active);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 		style: {
 			position: "relative",
@@ -268,7 +287,7 @@ function DefaultGroupTrigger({ view }) {
 		},
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 			type: "button",
-			onClick: () => setOpen((o) => !o),
+			onClick: () => setOpen((previous) => !previous),
 			"aria-haspopup": "menu",
 			"aria-expanded": isOpen,
 			title: "More",
@@ -276,169 +295,138 @@ function DefaultGroupTrigger({ view }) {
 				display: "inline-flex",
 				alignItems: "center",
 				padding: "4px 6px",
-				border: "1px solid rgba(0,0,0,0.15)",
+				color: "inherit",
+				font: "inherit",
+				border: `1px solid ${BORDER}`,
 				borderRadius: 4,
-				background: isOpen || someActive ? "rgba(0,0,0,0.12)" : "transparent",
+				background: isOpen || someActive ? ACTIVE : "transparent",
 				cursor: "pointer"
 			},
 			children: "▾"
-		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultOverflowMenu, { view: {
-			sections,
-			isOpen,
-			close: () => setOpen(false),
-			resolve: (id) => view.commands.find((c) => c.id === id) ?? null,
-			execute: view.execute
-		} })]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultOverflowMenu, {
+			view: (0, _embedpdf_core_ui.groupMenuView)(view, isOpen, () => setOpen(false)),
+			orientation
+		})]
 	});
 }
-const unitKey = (u, variant) => `u:${u.key}@${variant}`;
-const groupKey = (id) => `g:${id}`;
-const groupTriggerKey = (id) => `gt:${id}`;
-const TRIGGER_KEY = "t:";
-function Toolbar({ bar, gap = 8, separatorWidth = 1, className, style, renderCommand = defaultRenderCommand, renderCustom, renderCollapsed, renderGroupTrigger, renderSeparator = defaultRenderSeparator, renderOverflowTrigger = defaultRenderOverflowTrigger, renderOverflowMenu }) {
+function Toolbar({ bar, orientation = "horizontal", gap = 8, separatorWidth = 1, "aria-label": ariaLabel, className, style, renderCommand = defaultRenderCommand, renderCustom, renderCollapsed, renderGroupTrigger, renderSeparator, renderOverflowTrigger = defaultRenderOverflowTrigger, renderOverflowMenu }) {
 	const kernel = require_runtime.useKernel();
-	const commands = require_runtime.useCapability(_embedpdf_plugin_commands_contract.CommandsToken);
+	const commands = require_runtime.useCapability(_embedpdf_plugin_commands_contract_host.CommandsToken);
 	const documentId = require_runtime.useDocumentId();
+	const vertical = orientation === "vertical";
 	const [, force] = (0, react.useReducer)((x) => x + 1, 0);
 	(0, react.useEffect)(() => kernel.subscribe(force), [kernel]);
 	const containerRef = (0, react.useRef)(null);
-	const [containerWidth, setContainerWidth] = (0, react.useState)(0);
+	const [containerLength, setContainerLength] = (0, react.useState)(0);
+	(0, react.useLayoutEffect)(() => containerRef.current ? (0, _embedpdf_web.observeContentLength)(containerRef.current, orientation, setContainerLength) : void 0, [orientation]);
+	const [lengths] = (0, react.useState)(_embedpdf_web.createToolbarLengths);
+	const [, bumpMeasureVersion] = (0, react.useReducer)((version) => version + 1, 0);
+	const onLength = (0, react.useMemo)(() => (key, length) => {
+		if (lengths.report(orientation, key, length)) bumpMeasureVersion();
+	}, [lengths, orientation]);
+	const roving = (0, react.useRef)(null);
 	(0, react.useLayoutEffect)(() => {
-		const el = containerRef.current;
-		if (!el) return;
-		const observer = new ResizeObserver((entries) => {
-			const w = entries[entries.length - 1]?.contentRect.width;
-			if (w !== void 0) setContainerWidth((prev) => Math.abs(prev - w) > .5 ? w : prev);
-		});
-		observer.observe(el);
-		setContainerWidth(el.clientWidth);
-		return () => observer.disconnect();
-	}, []);
-	const widthsRef = (0, react.useRef)(/* @__PURE__ */ new Map());
-	const [, bumpMeasureVersion] = (0, react.useReducer)((x) => x + 1, 0);
-	const onWidth = (0, react.useMemo)(() => (key, width) => {
-		const prev = widthsRef.current.get(key);
-		if (prev !== void 0 && Math.abs(prev - width) <= .5) return;
-		widthsRef.current.set(key, width);
-		bumpMeasureVersion();
-	}, []);
-	const resolveCmd = (id) => commands.resolve(id, documentId ?? void 0);
-	const executeCmd = (id) => commands.execute(id, documentId ?? void 0);
-	const commandOf = (u) => u.kind === "command" ? u.command : u.terminal;
-	const visibleBar = (0, _embedpdf_core_ui.filterBar)((0, react.useMemo)(() => (0, _embedpdf_core_ui.normalizeBar)(bar), [bar]), (u) => resolveCmd(commandOf(u))?.visible === true);
-	const fit = (0, _embedpdf_core_ui.solve)(visibleBar, {
-		unit: (key, variant) => widthsRef.current.get(`u:${key}@${variant}`),
-		groupCollapsed: (id) => widthsRef.current.get(groupKey(id)),
-		groupTrigger: (id) => widthsRef.current.get(groupTriggerKey(id)),
-		overflowTrigger: widthsRef.current.get(TRIGGER_KEY) ?? 32,
-		gap,
-		separator: separatorWidth + gap
-	}, containerWidth);
-	const overflowSections = (0, _embedpdf_core_ui.projectOverflow)(visibleBar, fit, (id) => commands.menuTarget(id));
+		const toolbar = containerRef.current;
+		if (!toolbar) return;
+		const focus = (0, _embedpdf_web.attachToolbarFocus)(toolbar, orientation);
+		roving.current = focus;
+		return () => {
+			focus.detach();
+			roving.current = null;
+		};
+	}, [orientation]);
+	(0, react.useLayoutEffect)(() => roving.current?.refresh());
+	const resolveCmd = (id) => commands.resolveCommand(id, documentId ?? void 0);
+	const executeCmd = (id) => void commands.execute(id, { documentId: documentId ?? void 0 });
+	const layout = (0, _embedpdf_core_ui.layoutToolbar)({
+		bar: (0, react.useMemo)(() => (0, _embedpdf_core_ui.normalizeBar)(bar), [bar]),
+		resolve: resolveCmd,
+		unregistered: _embedpdf_plugin_commands_contract.unregisteredCommand,
+		execute: executeCmd,
+		menuTarget: (id) => commands.getMenuTarget(id),
+		metrics: lengths.metrics(orientation, gap, separatorWidth),
+		measureKey: _embedpdf_web.toolbarMeasureKey,
+		containerLength,
+		orientation
+	});
 	const [overflowOpen, setOverflowOpen] = (0, react.useState)(false);
 	(0, react.useEffect)(() => {
-		if (!fit.hasOverflow) setOverflowOpen(false);
-	}, [fit.hasOverflow]);
-	/** External = custom unit with no registered renderer → native socket,
-	*  live-measured (it must NOT appear in the measurement layer: only the
+		if (!layout.hasOverflow) setOverflowOpen(false);
+	}, [layout.hasOverflow]);
+	/** External = custom part with no registered renderer → native socket,
+	*  live-measured (it must not appear in the measurement layer: only the
 	*  first same-named <slot> in tree order receives the projected nodes). */
-	const isExternalSlot = (u) => u.kind === "custom" && !renderCustom?.[u.slot];
-	const renderUnitAt = (u, variant, layer) => {
-		if (u.kind === "custom") {
-			const registered = renderCustom?.[u.slot];
-			if (registered) {
-				const custom = registered(variant, {
-					layer,
-					measure: (width) => onWidth(unitKey(u, variant), width)
-				});
-				if (custom !== void 0) return custom;
-			} else if (layer === "live") {
-				const cmd = resolveCmd(u.terminal);
+	const isExternalSlot = (part) => part.kind === "custom" && !renderCustom?.[part.name];
+	const renderPart = (part, layer) => {
+		switch (part.kind) {
+			case "command": return renderCommand(part.command, part.variant, part.run);
+			case "custom": {
+				const terminal = () => part.terminal ? renderCommand(part.terminal, "icon", part.runTerminal) : null;
+				const registered = renderCustom?.[part.name];
+				if (registered) {
+					const custom = registered(part.variant, {
+						layer,
+						measure: (length) => onLength(part.measureKey, length)
+					});
+					return custom === void 0 ? terminal() : custom;
+				}
+				if (layer === "measure") return null;
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NativeSlotSocket, {
-					name: u.slot,
-					k: unitKey(u, variant),
-					onWidth,
-					children: cmd ? renderCommand(cmd, "icon", () => executeCmd(u.terminal)) : null
+					name: part.name,
+					k: part.measureKey,
+					orientation,
+					onLength,
+					children: terminal()
 				});
-			} else return null;
-			const cmd = resolveCmd(u.terminal);
-			return cmd ? renderCommand(cmd, "icon", () => executeCmd(u.terminal)) : null;
-		}
-		const cmd = resolveCmd(u.command);
-		if (!cmd) return renderCommand({
-			id: u.command,
-			label: u.command,
-			shortcuts: [],
-			enabled: false,
-			active: false,
-			visible: true,
-			categories: []
-		}, variant, () => {});
-		return renderCommand(cmd, variant, () => executeCmd(u.command));
-	};
-	const collapsedView = (g) => ({
-		id: g.id,
-		labelKey: g.labelKey,
-		collapse: g.collapse ?? "menu",
-		role: g.role,
-		commands: g.units.map((u) => resolveCmd(commandOf(u))).filter((c) => c !== null && c.visible),
-		execute: executeCmd
-	});
-	const renderCollapsedGroup = (g) => renderCollapsed ? renderCollapsed(collapsedView(g)) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultCollapsed, { view: collapsedView(g) });
-	/** The disclosure view: shed children for the live trigger; the WHOLE group
-	*  for the measured trigger, so width is budgeted at its fullest content. */
-	const disclosureView = (g, allChildren) => ({
-		id: g.id,
-		labelKey: g.labelKey,
-		role: g.role,
-		commands: g.units.filter((u) => allChildren || fit.units.get(u.key)?.kind === "shed").map((u) => resolveCmd(commandOf(u))).filter((c) => c !== null && c.visible),
-		execute: executeCmd
-	});
-	const renderDisclosure = (g, allChildren) => renderGroupTrigger ? renderGroupTrigger(disclosureView(g, allChildren)) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultGroupTrigger, { view: disclosureView(g, allChildren) });
-	const renderLiveGroup = (g) => {
-		const assignment = fit.groups.get(g.id);
-		if (!assignment || assignment.overflowed) return [];
-		if (assignment.collapsed) return [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: renderCollapsedGroup(g) }, g.id)];
-		const nodes = [];
-		for (const u of g.units) {
-			const a = fit.units.get(u.key);
-			if (a?.kind !== "variant") continue;
-			nodes.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: renderUnitAt(u, a.variant, "live") }, u.key));
+			}
+			case "collapsed": {
+				const drawn = renderCollapsed?.(part.view);
+				return drawn === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultCollapsed, {
+					view: part.view,
+					orientation
+				}) : drawn;
+			}
+			case "disclosure": {
+				const drawn = renderGroupTrigger?.(part.view);
+				return drawn === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultGroupTrigger, {
+					view: part.view,
+					orientation
+				}) : drawn;
+			}
 		}
-		if (assignment.shedCount > 0) nodes.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: renderDisclosure(g, false) }, `${g.id}::trigger`));
-		return nodes.length ? [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: nodes }, g.id)] : [];
-	};
-	const renderLiveSection = (section) => {
-		if (!section) return null;
-		return section.groups.map((g) => ({
-			id: g.id,
-			nodes: renderLiveGroup(g)
-		})).filter((g) => g.nodes.length > 0).map((g, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [i > 0 && renderSeparator(), g.nodes] }, g.id));
 	};
-	const sectionByName = (name) => visibleBar.sections.find((s) => s.name === name);
+	const renderLiveSection = (section) => section.groups.map((group, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [i > 0 && (renderSeparator ? renderSeparator() : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultSeparator, { orientation })), group.parts.map((part) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+		...TOOLBAR_ITEM,
+		style: ITEM_STYLE,
+		children: renderPart(part, "live")
+	}, part.key))] }, group.id));
 	/**
-	* Segment layout — v2's spacer model, natively. The center segment carries
-	* auto margins: it BALANCES in the leftover space (true center when the
-	* flanks are symmetric) and yields when they aren't, collapsing to zero
-	* before anything can overlap. The container itself has NO gap — segments
-	* space themselves — so the solver's global budget (sum of unit widths +
-	* per-unit gaps) is exactly the layout's minimum width: what the solver
+	* Segment layout, along the toolbar's axis. The center segment carries auto
+	* margins: it balances in the leftover space (true center when the flanks
+	* are symmetric) and yields when they aren't, collapsing to zero before
+	* anything can overlap. The container itself has no gap — segments space
+	* themselves — so the solver's global budget (sum of unit lengths +
+	* per-unit gaps) is exactly the layout's minimum length: what the solver
 	* says fits, fits. Its cross-segment gap allowance (≤ 2×gap) becomes slack
 	* the auto margins absorb, keeping ≥ gap between segments at the floor.
-	* Segments never grow or shrink: fit is the SOLVER's job, not flexbox's.
+	* Segments never grow or shrink: fit is the solver's job, not flexbox's.
 	*/
 	const sectionStyle = (position) => ({
 		display: "flex",
+		flexDirection: vertical ? "column" : "row",
 		alignItems: "center",
 		gap,
 		flex: "0 0 auto",
-		...position === "center" ? {
+		...position !== "center" ? null : vertical ? {
+			marginTop: "auto",
+			marginBottom: "auto"
+		} : {
 			marginLeft: "auto",
 			marginRight: "auto"
-		} : null
+		}
 	});
 	const overflowView = {
-		sections: overflowSections,
+		sections: layout.overflow,
 		isOpen: overflowOpen,
 		close: () => setOverflowOpen(false),
 		resolve: resolveCmd,
@@ -446,70 +434,84 @@ function Toolbar({ bar, gap = 8, separatorWidth = 1, className, style, renderCom
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		ref: containerRef,
+		role: "toolbar",
+		"aria-orientation": orientation,
+		"aria-label": ariaLabel,
 		className,
 		style: {
 			position: "relative",
 			display: "flex",
+			flexDirection: vertical ? "column" : "row",
 			alignItems: "center",
 			...style
 		},
-		children: [
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				style: sectionStyle("start"),
-				children: renderLiveSection(sectionByName("start"))
-			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				style: sectionStyle("center"),
-				children: renderLiveSection(sectionByName("center"))
-			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				style: sectionStyle("end"),
-				children: [renderLiveSection(sectionByName("end")), fit.hasOverflow && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-					style: {
-						position: "relative",
-						display: "inline-flex"
-					},
-					children: [renderOverflowTrigger(overflowOpen, () => setOverflowOpen((o) => !o)), renderOverflowMenu ? renderOverflowMenu(overflowView) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultOverflowMenu, { view: overflowView })]
-				})]
-			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				"aria-hidden": true,
-				style: measureLayerStyle,
-				children: [visibleBar.sections.flatMap((s) => s.groups.flatMap((g) => [
-					...g.units.filter((u) => !isExternalSlot(u)).flatMap((u) => u.variants.map((variant) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Measured, {
-						k: unitKey(u, variant),
-						onWidth,
-						children: renderUnitAt(u, variant, "measure")
-					}, unitKey(u, variant)))),
-					...g.collapse ? [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Measured, {
-						k: groupKey(g.id),
-						onWidth,
-						children: renderCollapsedGroup(g)
-					}, groupKey(g.id))] : [],
-					...g.shed ? [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Measured, {
-						k: groupTriggerKey(g.id),
-						onWidth,
-						children: renderDisclosure(g, true)
-					}, groupTriggerKey(g.id))] : []
-				])), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Measured, {
-					k: TRIGGER_KEY,
-					onWidth,
-					children: renderOverflowTrigger(false, () => {})
+		children: [layout.sections.map((section) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			style: sectionStyle(section.name),
+			children: [renderLiveSection(section), section.name === "end" && layout.hasOverflow && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				...TOOLBAR_ITEM,
+				style: {
+					position: "relative",
+					display: "inline-flex"
+				},
+				children: [renderOverflowTrigger(overflowOpen, () => setOverflowOpen((previous) => !previous)), renderOverflowMenu ? renderOverflowMenu(overflowView) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefaultOverflowMenu, {
+					view: overflowView,
+					orientation
 				})]
-			})
-		]
+			})]
+		}, section.name)), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			"aria-hidden": true,
+			...require_inert.INERT,
+			style: measureLayerStyle(orientation),
+			children: [layout.measured.filter((part) => !isExternalSlot(part)).map((part) => {
+				const drawn = renderPart(part, "measure");
+				if (part.kind === "custom" && drawn === null) return null;
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Measured, {
+					k: part.measureKey,
+					orientation,
+					onLength,
+					children: drawn
+				}, part.measureKey);
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Measured, {
+				k: _embedpdf_web.toolbarMeasureKey.overflowTrigger,
+				orientation,
+				onLength,
+				children: renderOverflowTrigger(false, () => {})
+			})]
+		})]
 	});
 }
 //#endregion
+Object.defineProperty(exports, "DEFAULT_IMPORTANCE", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_ui.DEFAULT_IMPORTANCE;
+	}
+});
+Object.defineProperty(exports, "PINNED", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_ui.PINNED;
+	}
+});
 exports.Toolbar = Toolbar;
-exports.useStripView = useStripView;
-Object.keys(_embedpdf_core_ui).forEach(function(k) {
-	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-		enumerable: true,
-		get: function() {
-			return _embedpdf_core_ui[k];
-		}
-	});
+Object.defineProperty(exports, "custom", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_ui.custom;
+	}
+});
+Object.defineProperty(exports, "group", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_ui.group;
+	}
 });
+Object.defineProperty(exports, "item", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_ui.item;
+	}
+});
+exports.useStripView = useStripView;
 
 //# sourceMappingURL=toolbar.cjs.map