@agimon-ai/po-web-dashboard 0.0.0-alpha.0

package/dist/web/lib/composition.mjs

@@ -0,0 +1,392 @@
+import { isDesktopClient, pluginActivityGroups, pluginDockFaces, pluginFileLinks, pluginMinorModes, pluginSelectionAxes, subscribeWebPluginRegistry, webPluginRegistryRevision } from "./pluginRegistry.mjs";
+import { stripAnsi } from "./statusLine.mjs";
+import { useCallback, useSyncExternalStore } from "react";
+//#region src/web/lib/composition.ts
+const AXIS_LIST_SEPARATOR = ",";
+/**
+* The fallback axis table for the packaged bundle; a synced bundle carries
+* each axis as its owning package's plugin declaration, and the registry
+* list wins whenever any plugin declares one. Exported only so the workspace
+* composition test can hold it equal to what the packages declare.
+*/
+const PACKAGED_SELECTION_AXES = [{
+	name: "profile",
+	command: "profile",
+	statusKey: "doom-profile",
+	emptyLabel: "no profile",
+	order: 10
+}, {
+	name: "domains",
+	command: "domains",
+	statusKey: "doom-domain",
+	emptyLabel: "no domains",
+	multi: true,
+	order: 20
+}];
+/**
+* The declared axes the session actually offers: an axis whose status key
+* the session never published stays off the bar entirely, which is how a
+* package withholds its axis when there is nothing to select.
+*/
+function selectionAxes(statuses) {
+	const declared = pluginSelectionAxes();
+	return (declared.length > 0 ? declared : PACKAGED_SELECTION_AXES).flatMap((source) => {
+		const raw = statuses[source.statusKey];
+		if (raw === void 0) return [];
+		const multi = source.multi === true;
+		const values = (multi ? stripAnsi(raw).split(AXIS_LIST_SEPARATOR) : [stripAnsi(raw)]).map((value) => value.trim()).filter(Boolean);
+		return [{
+			name: source.name,
+			command: source.command,
+			values,
+			emptyLabel: source.emptyLabel,
+			multi
+		}];
+	});
+}
+/**
+* The fallback minor-mode table for the packaged bundle.
+*
+* A synced bundle carries each mode as its package's own web plugin
+* contribution, and the registry list wins whenever any plugin declares one.
+* This literal survives only so the built-in-only bundle keeps rendering the
+* modes Po ships; help is listed without a signal on purpose: it
+* registers no footer entry, so the cockpit reports it as unavailable rather
+* than guessing it is off. Exported only for the workspace composition test.
+*/
+const PACKAGED_MINOR_MODES = [
+	{
+		name: "help",
+		keys: "h e"
+	},
+	{
+		name: "plan",
+		keys: "p e",
+		statusKey: "plan-mode"
+	},
+	{
+		name: "loop",
+		keys: "l l",
+		statusKey: "doom-loop"
+	},
+	{
+		name: "goal",
+		keys: "g e",
+		statusKey: "goal"
+	},
+	{
+		name: "author",
+		keys: "o a"
+	},
+	{
+		name: "workflow",
+		keys: "w e",
+		widgetKey: "workflow-mcp-progress"
+	},
+	{
+		name: "voice",
+		modeId: "voice-auto",
+		keys: "v e",
+		statusKey: "doom-voice"
+	},
+	{
+		name: "computer use",
+		modeId: "computer-use",
+		keys: "c e",
+		statusKey: "doom-computer-use-mode",
+		hideWhenMissing: true,
+		desktopOnly: true
+	}
+];
+/** The declared source a catalog mode corresponds to, by id, id stem, or label. */
+function sourceFor(sources, mode) {
+	const candidates = /* @__PURE__ */ new Set([
+		mode.id.toLowerCase(),
+		mode.id.toLowerCase().split(".")[0],
+		mode.label.toLowerCase()
+	]);
+	return sources.find((source) => [source.name, source.modeId].some((identity) => identity !== void 0 && candidates.has(identity.toLowerCase())));
+}
+/**
+* Catalog-backed rows: the runtime's own activation state per mode, with the
+* declared leader keys attached where a plugin documents them. Declared modes
+* the catalog does not know are still listed, as unavailable, so a mode that
+* is missing from a composition stays visible rather than silently gone.
+*/
+function catalogMinorModes(sources, projection) {
+	const rows = projection.modes.filter((mode) => !sourceFor(sources, mode)?.desktopOnly || isDesktopClient()).map((mode) => {
+		const source = sourceFor(sources, mode);
+		const on = mode.activation === "active" || mode.activation === "deactivating";
+		const blocked = mode.actions.length > 0 && mode.actions.every((action) => !action.enabled);
+		const reason = blocked ? mode.actions.find((action) => action.disabledReason)?.disabledReason ?? "" : "";
+		return {
+			name: source?.name ?? mode.label.toLowerCase(),
+			id: mode.id,
+			keys: source?.keys ?? "",
+			availability: blocked && !on ? "unavailable" : on ? "on" : "off",
+			...source?.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: mode.detail ?? (mode.activation === "activating" ? "activating" : ""),
+			unavailableReason: reason
+		};
+	});
+	const seen = new Set(rows.map((row) => row.name));
+	for (const source of sources) {
+		if (source.hideWhenMissing === true || source.desktopOnly && !isDesktopClient()) continue;
+		if (!seen.has(source.name)) rows.push({
+			name: source.name,
+			id: source.modeId ?? source.name,
+			keys: source.keys,
+			availability: "unavailable",
+			...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: "",
+			unavailableReason: "No package in this session registers this mode."
+		});
+	}
+	return rows;
+}
+function minorModes(statuses, widgets, projection = null) {
+	const declared = pluginMinorModes();
+	const sources = declared.length > 0 ? declared : PACKAGED_MINOR_MODES;
+	if (projection) return catalogMinorModes(sources, projection);
+	return sources.flatMap((source) => {
+		if (source.desktopOnly && !isDesktopClient()) return [];
+		if (source.statusKey !== void 0) {
+			const raw = statuses[source.statusKey];
+			if (raw === void 0) {
+				if (source.hideWhenMissing === true) return [];
+				return [{
+					name: source.name,
+					id: source.modeId ?? source.name,
+					keys: source.keys,
+					availability: "unavailable",
+					...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+					detail: "",
+					unavailableReason: "This session has not reported the mode."
+				}];
+			}
+			const detail = stripAnsi(raw).trim();
+			return {
+				name: source.name,
+				id: source.modeId ?? source.name,
+				keys: source.keys,
+				availability: detail ? "on" : "off",
+				...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+				detail,
+				unavailableReason: ""
+			};
+		}
+		if (source.widgetKey !== void 0 && widgets.includes(source.widgetKey)) return {
+			name: source.name,
+			id: source.modeId ?? source.name,
+			keys: source.keys,
+			availability: "off",
+			...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: "",
+			unavailableReason: ""
+		};
+		return {
+			name: source.name,
+			id: source.name,
+			keys: source.keys,
+			availability: "unavailable",
+			...source.activityGroup === void 0 ? {} : { activityGroup: source.activityGroup },
+			detail: "",
+			unavailableReason: "This session has not reported the mode."
+		};
+	});
+}
+/** Subscribe to package-owned activity sources, rewiring when the focused composition changes. */
+function subscribeActivitySources(listener) {
+	let subscriptions = [];
+	const unsubscribeSources = () => {
+		subscriptions.forEach((unsubscribe) => unsubscribe());
+		subscriptions = [];
+	};
+	const subscribeSources = () => {
+		subscriptions = pluginActivityGroups().flatMap((source) => source.activeSource === void 0 ? [] : [source.activeSource.subscribe(listener)]);
+	};
+	subscribeSources();
+	const unsubscribeRegistry = subscribeWebPluginRegistry(() => {
+		unsubscribeSources();
+		subscribeSources();
+		listener();
+	});
+	return () => {
+		unsubscribeRegistry();
+		unsubscribeSources();
+	};
+}
+function activitySourceFingerprint(sessionId) {
+	const activeSources = pluginActivityGroups().map((source) => source.activeSource?.isActive(sessionId) === true ? "1" : "0").join("");
+	return `${webPluginRegistryRevision()}:${activeSources}`;
+}
+/**
+* The groups available in this plugin composition. Status and widget signals
+* reveal legacy groups. A package-owned active source also reveals its group,
+* including while idle, so the section can remain a stable launcher unless it
+* opts into `hideWhenEmpty`.
+*
+* A group that declared `hideWhenEmpty` goes away once its session stops
+* reporting. Clearing a status reaches the page as an empty string rather than
+* an absent key, because the same map tells the selection bar which minor modes
+* exist and an absent key means "not reported" there. Emptiness is read here,
+* where only the dock is looking.
+*/
+function activityGroups(statuses, widgets, sessionId = null) {
+	const groups = [];
+	for (const source of pluginActivityGroups()) {
+		const tab = source.transientTab === void 0 ? {} : { transientTab: source.transientTab };
+		const placement = {
+			...source.placement === void 0 ? {} : { placement: source.placement },
+			...source.marksBackgroundWork === false ? { marksBackgroundWork: false } : {},
+			...source.icon === void 0 ? {} : { icon: source.icon }
+		};
+		if (source.statusKey !== void 0 && statuses[source.statusKey] !== void 0) {
+			const summary = stripAnsi(statuses[source.statusKey] ?? "").trim();
+			const active = source.activeSource?.isActive(sessionId) ?? (source.marksBackgroundWork !== false && summary.length > 0);
+			if (summary.length === 0 && source.hideWhenEmpty === true && !active) continue;
+			groups.push({
+				name: source.name,
+				keys: source.keys,
+				summary,
+				active,
+				...tab,
+				...placement
+			});
+			continue;
+		}
+		if (source.widgetKeys !== void 0 && source.widgetKeys.some((key) => widgets.includes(key))) {
+			const activeKeys = source.activeWidgetKeys ?? source.widgetKeys;
+			const active = source.activeSource?.isActive(sessionId) ?? (source.marksBackgroundWork !== false && activeKeys.some((key) => widgets.includes(key)));
+			groups.push({
+				name: source.name,
+				keys: source.keys,
+				summary: "",
+				active,
+				...tab,
+				...placement
+			});
+			continue;
+		}
+		if (source.activeSource !== void 0) {
+			const active = source.activeSource.isActive(sessionId);
+			if (source.hideWhenEmpty === true && !active) continue;
+			groups.push({
+				name: source.name,
+				keys: source.keys,
+				summary: "",
+				active,
+				...tab,
+				...placement
+			});
+		}
+	}
+	return groups;
+}
+/** Dock faces update when the active session composition changes. */
+function useDockFaces(sessionId) {
+	useSyncExternalStore(subscribeWebPluginRegistry, webPluginRegistryRevision, webPluginRegistryRevision);
+	const subscribe = (listener) => {
+		const releases = pluginDockFaces().flatMap((face) => face.visibility ? [face.visibility.subscribe(listener)] : []);
+		return () => releases.forEach((release) => release());
+	};
+	const snapshot = () => pluginDockFaces().map((face) => face.visibility?.isVisible(sessionId) !== false ? "1" : "0").join("");
+	useSyncExternalStore(subscribe, snapshot, snapshot);
+	return pluginDockFaces().filter((face) => face.visibility?.isVisible(sessionId) !== false);
+}
+/** Activity groups that update when either host signals or a plugin's session store changes. */
+function useActivityGroups(statuses, widgets, sessionId) {
+	useSyncExternalStore(subscribeActivitySources, () => activitySourceFingerprint(sessionId), () => activitySourceFingerprint(sessionId));
+	return activityGroups(statuses, widgets, sessionId);
+}
+let fileLinkModes;
+const modeBindings = /* @__PURE__ */ new Set();
+/** Binds host session facts without making the composition library own session state. */
+function bindFileLinkModes(source) {
+	fileLinkModes = source;
+	modeBindings.forEach((listener) => listener());
+	return () => {
+		if (fileLinkModes !== source) return;
+		fileLinkModes = void 0;
+		modeBindings.forEach((listener) => listener());
+	};
+}
+function subscribeFileLinks(sessionId, listener) {
+	let unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);
+	const rebindModes = () => {
+		unsubscribeModes?.();
+		unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);
+		listener();
+	};
+	modeBindings.add(rebindModes);
+	let subscriptions = [];
+	const unsubscribeSources = () => {
+		subscriptions.forEach((unsubscribe) => unsubscribe());
+		subscriptions = [];
+	};
+	const subscribeSources = () => {
+		subscriptions = pluginFileLinks().map((source) => source.subscribe(listener));
+	};
+	subscribeSources();
+	const unsubscribeRegistry = subscribeWebPluginRegistry(() => {
+		unsubscribeSources();
+		subscribeSources();
+		listener();
+	});
+	return () => {
+		modeBindings.delete(rebindModes);
+		unsubscribeModes?.();
+		unsubscribeRegistry();
+		unsubscribeSources();
+	};
+}
+function activeFileLinkSources(sessionId) {
+	const enabled = new Set(fileLinkModes?.active(sessionId) ?? []);
+	return pluginFileLinks().filter((source) => source.requiredMinorMode === void 0 || enabled.has(source.requiredMinorMode));
+}
+function fileLinkFingerprint(sessionId) {
+	const sourceFingerprints = activeFileLinkSources(sessionId).map((source) => `${source.requiredMinorMode ?? ""}:${source.fingerprint(sessionId)}`).join("\n");
+	return `${webPluginRegistryRevision()}:${sourceFingerprints}`;
+}
+/**
+* The tab a path opens, from the first source that claims it.
+*
+* A path no source claims is not a link. The host cannot tell a file name from
+* a class name, and the plugin that tracks the session's files can, so the
+* decision belongs there rather than in a heuristic here.
+*/
+function fileLinkFor(sessionId, path) {
+	for (const source of activeFileLinkSources(sessionId)) {
+		const tab = source.resolve(sessionId, path);
+		if (tab !== void 0) return tab;
+	}
+}
+/**
+* The tab a path the caller is sure about opens: a tool call's path argument,
+* not a token spotted in prose.
+*
+* A source that offers `openPath` answers here, and it may claim a file the
+* session never changed, which `resolve` deliberately will not. Sources
+* without it fall back to the same guess prose gets.
+*/
+function fileTabForPath(sessionId, path) {
+	for (const source of activeFileLinkSources(sessionId)) {
+		const tab = source.openPath?.(sessionId, path) ?? source.resolve(sessionId, path);
+		if (tab !== void 0) return tab;
+	}
+}
+/**
+* Resolves the paths a message names against the plugins that track them.
+*
+* The resolver's identity is stable while the linkable set is, so a component
+* that hands it to a renderer does not rebuild that renderer on every frame of
+* a streaming reply.
+*/
+function useFileLinks(sessionId) {
+	const fingerprint = useSyncExternalStore(useCallback((listener) => subscribeFileLinks(sessionId, listener), [sessionId]), () => fileLinkFingerprint(sessionId), () => fileLinkFingerprint(sessionId));
+	return useCallback((path) => fileLinkFor(sessionId, path), [sessionId, fingerprint]);
+}
+//#endregion
+export { PACKAGED_MINOR_MODES, PACKAGED_SELECTION_AXES, activityGroups, bindFileLinkModes, fileLinkFor, fileTabForPath, minorModes, selectionAxes, subscribeActivitySources, useActivityGroups, useDockFaces, useFileLinks };
+
+//# sourceMappingURL=composition.mjs.map

package/dist/web/lib/composition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.mjs","names":[],"sources":["../../../src/web/lib/composition.ts"],"sourcesContent":["import type {\n  ActivityGroupContribution,\n  DockFaceContribution,\n  SelectionAxisContribution,\n  TransientTab,\n} from '@agimon-ai/po-core/web';\nimport { useCallback, useSyncExternalStore } from 'react';\n\nimport type { MinorModeProjection, MinorModeRecordProjection } from '../../types/hub';\nimport {\n  isDesktopClient,\n  pluginActivityGroups,\n  pluginDockFaces,\n  pluginFileLinks,\n  pluginMinorModes,\n  pluginSelectionAxes,\n  subscribeWebPluginRegistry,\n  webPluginRegistryRevision,\n} from './pluginRegistry';\nimport { stripAnsi } from './statusLine';\n\nexport interface SelectionAxis {\n  name: string;\n  command: string;\n  /** The current selections, empty while the session reports none; one at most unless multi. */\n  values: string[];\n  emptyLabel: string;\n  multi: boolean;\n}\n\nconst AXIS_LIST_SEPARATOR = ',';\n\n/**\n * The fallback axis table for the packaged bundle; a synced bundle carries\n * each axis as its owning package's plugin declaration, and the registry\n * list wins whenever any plugin declares one. Exported only so the workspace\n * composition test can hold it equal to what the packages declare.\n */\nexport const PACKAGED_SELECTION_AXES: readonly SelectionAxisContribution[] = [\n  { name: 'profile', command: 'profile', statusKey: 'doom-profile', emptyLabel: 'no profile', order: 10 },\n  { name: 'domains', command: 'domains', statusKey: 'doom-domain', emptyLabel: 'no domains', multi: true, order: 20 },\n];\n\n/**\n * The declared axes the session actually offers: an axis whose status key\n * the session never published stays off the bar entirely, which is how a\n * package withholds its axis when there is nothing to select.\n */\nexport function selectionAxes(statuses: Record<string, string>): SelectionAxis[] {\n  const declared = pluginSelectionAxes();\n  const sources: readonly SelectionAxisContribution[] = declared.length > 0 ? declared : PACKAGED_SELECTION_AXES;\n  return sources.flatMap((source) => {\n    const raw = statuses[source.statusKey];\n    if (raw === undefined) return [];\n    const multi = source.multi === true;\n    const values = (multi ? stripAnsi(raw).split(AXIS_LIST_SEPARATOR) : [stripAnsi(raw)])\n      .map((value) => value.trim())\n      .filter(Boolean);\n    return [{ name: source.name, command: source.command, values, emptyLabel: source.emptyLabel, multi }];\n  });\n}\n\nexport type MinorModeAvailability = 'unavailable' | 'off' | 'on';\n\nexport interface MinorMode {\n  name: string;\n  /** The catalog id /minor accepts; the display name until the catalog reports. */\n  id: string;\n  /** Leader Space key path, as the TUI documents it. */\n  keys: string;\n  availability: MinorModeAvailability;\n  /** What the mode itself is reporting while on. */\n  detail: string;\n  /** Activity group to focus instead of invoking the mode command from the cockpit. */\n  activityGroup?: string;\n  /**\n   * Why the mode cannot be driven from here, in the words of the mode itself.\n   * Empty when it can. A mode may be installed and still refuse a cockpit:\n   * autonomous voice captures from the terminal's own microphone, which a\n   * browser talking to a headless agent does not have.\n   */\n  unavailableReason: string;\n}\n\nexport interface MinorModeSource {\n  name: string;\n  /** The catalog mode this row drives, when the runtime registers it under another id. */\n  modeId?: string;\n  /** Leader Space key path, as the TUI documents it. */\n  keys: string;\n  /** Activity group to focus instead of invoking the mode command from the cockpit. */\n  activityGroup?: string;\n  statusKey?: string;\n  widgetKey?: string;\n  hideWhenMissing?: boolean;\n  desktopOnly?: boolean;\n}\n\n/**\n * The fallback minor-mode table for the packaged bundle.\n *\n * A synced bundle carries each mode as its package's own web plugin\n * contribution, and the registry list wins whenever any plugin declares one.\n * This literal survives only so the built-in-only bundle keeps rendering the\n * modes Po ships; help is listed without a signal on purpose: it\n * registers no footer entry, so the cockpit reports it as unavailable rather\n * than guessing it is off. Exported only for the workspace composition test.\n */\nexport const PACKAGED_MINOR_MODES: readonly MinorModeSource[] = [\n  { name: 'help', keys: 'h e' },\n  { name: 'plan', keys: 'p e', statusKey: 'plan-mode' },\n  { name: 'loop', keys: 'l l', statusKey: 'doom-loop' },\n  { name: 'goal', keys: 'g e', statusKey: 'goal' },\n  { name: 'author', keys: 'o a' },\n  { name: 'workflow', keys: 'w e', widgetKey: 'workflow-mcp-progress' },\n  // `v e` drives autonomous capture, which the runtime registers as 'voice-auto'.\n  { name: 'voice', modeId: 'voice-auto', keys: 'v e', statusKey: 'doom-voice' },\n  {\n    name: 'computer use',\n    modeId: 'computer-use',\n    keys: 'c e',\n    statusKey: 'doom-computer-use-mode',\n    hideWhenMissing: true,\n    desktopOnly: true,\n  },\n];\n\n/** The declared source a catalog mode corresponds to, by id, id stem, or label. */\nfunction sourceFor(sources: readonly MinorModeSource[], mode: MinorModeRecordProjection): MinorModeSource | undefined {\n  const candidates = new Set([mode.id.toLowerCase(), mode.id.toLowerCase().split('.')[0], mode.label.toLowerCase()]);\n  return sources.find((source) =>\n    [source.name, source.modeId].some((identity) => identity !== undefined && candidates.has(identity.toLowerCase())),\n  );\n}\n\n/**\n * Catalog-backed rows: the runtime's own activation state per mode, with the\n * declared leader keys attached where a plugin documents them. Declared modes\n * the catalog does not know are still listed, as unavailable, so a mode that\n * is missing from a composition stays visible rather than silently gone.\n */\nfunction catalogMinorModes(sources: readonly MinorModeSource[], projection: MinorModeProjection): MinorMode[] {\n  const rows: MinorMode[] = projection.modes\n    .filter((mode) => !sourceFor(sources, mode)?.desktopOnly || isDesktopClient())\n    .map((mode) => {\n      const source = sourceFor(sources, mode);\n      const on = mode.activation === 'active' || mode.activation === 'deactivating';\n      // The catalog says per action whether it can run here and why not. A mode\n      // with nothing runnable is offered as a row that cannot be clicked rather\n      // than one that answers \"no actions available\" after the fact.\n      const blocked = mode.actions.length > 0 && mode.actions.every((action) => !action.enabled);\n      const reason = blocked ? (mode.actions.find((action) => action.disabledReason)?.disabledReason ?? '') : '';\n      return {\n        name: source?.name ?? mode.label.toLowerCase(),\n        id: mode.id,\n        keys: source?.keys ?? '',\n        availability: blocked && !on ? 'unavailable' : on ? 'on' : 'off',\n        ...(source?.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail: mode.detail ?? (mode.activation === 'activating' ? 'activating' : ''),\n        unavailableReason: reason,\n      };\n    });\n  const seen = new Set(rows.map((row) => row.name));\n  for (const source of sources) {\n    if (source.hideWhenMissing === true || (source.desktopOnly && !isDesktopClient())) continue;\n    if (!seen.has(source.name)) {\n      rows.push({\n        name: source.name,\n        id: source.modeId ?? source.name,\n        keys: source.keys,\n        availability: 'unavailable',\n        ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail: '',\n        unavailableReason: 'No package in this session registers this mode.',\n      });\n    }\n  }\n  return rows;\n}\n\nexport function minorModes(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  projection: MinorModeProjection | null = null,\n): MinorMode[] {\n  const declared = pluginMinorModes();\n  const sources: readonly MinorModeSource[] = declared.length > 0 ? declared : PACKAGED_MINOR_MODES;\n  if (projection) return catalogMinorModes(sources, projection);\n  return sources.flatMap((source) => {\n    if (source.desktopOnly && !isDesktopClient()) return [];\n    if (source.statusKey !== undefined) {\n      const raw = statuses[source.statusKey];\n      if (raw === undefined) {\n        if (source.hideWhenMissing === true) return [];\n        return [\n          {\n            name: source.name,\n            id: source.modeId ?? source.name,\n            keys: source.keys,\n            availability: 'unavailable' as const,\n            ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n            detail: '',\n            unavailableReason: 'This session has not reported the mode.',\n          },\n        ];\n      }\n      const detail = stripAnsi(raw).trim();\n      return {\n        name: source.name,\n        id: source.modeId ?? source.name,\n        keys: source.keys,\n        availability: detail ? ('on' as const) : ('off' as const),\n        ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail,\n        unavailableReason: '',\n      };\n    }\n    if (source.widgetKey !== undefined && widgets.includes(source.widgetKey)) {\n      return {\n        name: source.name,\n        id: source.modeId ?? source.name,\n        keys: source.keys,\n        availability: 'off' as const,\n        ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n        detail: '',\n        unavailableReason: '',\n      };\n    }\n    return {\n      name: source.name,\n      id: source.name,\n      keys: source.keys,\n      availability: 'unavailable' as const,\n      ...(source.activityGroup === undefined ? {} : { activityGroup: source.activityGroup }),\n      detail: '',\n      unavailableReason: 'This session has not reported the mode.',\n    };\n  });\n}\n\nexport interface ActivityGroup {\n  name: string;\n  keys: string;\n  /** The heading visual its package declares; the dock draws a generic one without it. */\n  icon?: ActivityGroupContribution['icon'];\n  /** What the publishing extension is reporting, empty when it reports nothing. */\n  summary: string;\n  active: boolean;\n  marksBackgroundWork?: boolean;\n  /** The temporary tab the group's name opens, when its package declares one. */\n  transientTab?: () => TransientTab;\n  /** Keeps the group visible below the dock's scrolling ordinary groups. */\n  placement?: 'bottom';\n}\n\n/** Subscribe to package-owned activity sources, rewiring when the focused composition changes. */\nexport function subscribeActivitySources(listener: () => void): () => void {\n  let subscriptions: (() => void)[] = [];\n  const unsubscribeSources = (): void => {\n    subscriptions.forEach((unsubscribe) => unsubscribe());\n    subscriptions = [];\n  };\n  const subscribeSources = (): void => {\n    subscriptions = pluginActivityGroups().flatMap((source) =>\n      source.activeSource === undefined ? [] : [source.activeSource.subscribe(listener)],\n    );\n  };\n  subscribeSources();\n  const unsubscribeRegistry = subscribeWebPluginRegistry(() => {\n    unsubscribeSources();\n    subscribeSources();\n    listener();\n  });\n  return () => {\n    unsubscribeRegistry();\n    unsubscribeSources();\n  };\n}\n\nfunction activitySourceFingerprint(sessionId: string | null): string {\n  const activeSources = pluginActivityGroups()\n    .map((source) => (source.activeSource?.isActive(sessionId) === true ? '1' : '0'))\n    .join('');\n  return `${webPluginRegistryRevision()}:${activeSources}`;\n}\n\n/**\n * The groups available in this plugin composition. Status and widget signals\n * reveal legacy groups. A package-owned active source also reveals its group,\n * including while idle, so the section can remain a stable launcher unless it\n * opts into `hideWhenEmpty`.\n *\n * A group that declared `hideWhenEmpty` goes away once its session stops\n * reporting. Clearing a status reaches the page as an empty string rather than\n * an absent key, because the same map tells the selection bar which minor modes\n * exist and an absent key means \"not reported\" there. Emptiness is read here,\n * where only the dock is looking.\n */\nexport function activityGroups(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  sessionId: string | null = null,\n): ActivityGroup[] {\n  const groups: ActivityGroup[] = [];\n  for (const source of pluginActivityGroups()) {\n    const tab = source.transientTab === undefined ? {} : { transientTab: source.transientTab };\n    const placement = {\n      ...(source.placement === undefined ? {} : { placement: source.placement }),\n      ...(source.marksBackgroundWork === false ? { marksBackgroundWork: false } : {}),\n      ...(source.icon === undefined ? {} : { icon: source.icon }),\n    };\n    if (source.statusKey !== undefined && statuses[source.statusKey] !== undefined) {\n      const summary = stripAnsi(statuses[source.statusKey] ?? '').trim();\n      const active =\n        source.activeSource?.isActive(sessionId) ?? (source.marksBackgroundWork !== false && summary.length > 0);\n      if (summary.length === 0 && source.hideWhenEmpty === true && !active) continue;\n      groups.push({ name: source.name, keys: source.keys, summary, active, ...tab, ...placement });\n      continue;\n    }\n    if (source.widgetKeys !== undefined && source.widgetKeys.some((key) => widgets.includes(key))) {\n      const activeKeys = source.activeWidgetKeys ?? source.widgetKeys;\n      const active =\n        source.activeSource?.isActive(sessionId) ??\n        (source.marksBackgroundWork !== false && activeKeys.some((key) => widgets.includes(key)));\n      groups.push({ name: source.name, keys: source.keys, summary: '', active, ...tab, ...placement });\n      continue;\n    }\n    if (source.activeSource !== undefined) {\n      const active = source.activeSource.isActive(sessionId);\n      if (source.hideWhenEmpty === true && !active) continue;\n      groups.push({\n        name: source.name,\n        keys: source.keys,\n        summary: '',\n        active,\n        ...tab,\n        ...placement,\n      });\n    }\n  }\n  return groups;\n}\n\n/** Dock faces update when the active session composition changes. */\nexport function useDockFaces(sessionId: string | null): readonly DockFaceContribution[] {\n  useSyncExternalStore(subscribeWebPluginRegistry, webPluginRegistryRevision, webPluginRegistryRevision);\n  const subscribe = (listener: () => void) => {\n    const releases = pluginDockFaces().flatMap((face) =>\n      face.visibility ? [face.visibility.subscribe(listener)] : [],\n    );\n    return () => releases.forEach((release) => release());\n  };\n  const snapshot = () =>\n    pluginDockFaces()\n      .map((face) => (face.visibility?.isVisible(sessionId) !== false ? '1' : '0'))\n      .join('');\n  useSyncExternalStore(subscribe, snapshot, snapshot);\n  return pluginDockFaces().filter((face) => face.visibility?.isVisible(sessionId) !== false);\n}\n\n/** Activity groups that update when either host signals or a plugin's session store changes. */\nexport function useActivityGroups(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  sessionId: string | null,\n): ActivityGroup[] {\n  useSyncExternalStore(\n    subscribeActivitySources,\n    () => activitySourceFingerprint(sessionId),\n    () => activitySourceFingerprint(sessionId),\n  );\n  return activityGroups(statuses, widgets, sessionId);\n}\n\n/** The tab one path opens, or undefined when no installed plugin recognises it. */\nexport type FileLinkResolver = (path: string) => TransientTab | undefined;\n\ninterface FileLinkModes {\n  active(sessionId: string | null): readonly string[];\n  subscribe(sessionId: string | null, listener: () => void): () => void;\n}\nlet fileLinkModes: FileLinkModes | undefined;\nconst modeBindings = new Set<() => void>();\n\n/** Binds host session facts without making the composition library own session state. */\nexport function bindFileLinkModes(source: FileLinkModes): () => void {\n  fileLinkModes = source;\n  modeBindings.forEach((listener) => listener());\n  return () => {\n    if (fileLinkModes !== source) return;\n    fileLinkModes = undefined;\n    modeBindings.forEach((listener) => listener());\n  };\n}\nfunction subscribeFileLinks(sessionId: string | null, listener: () => void): () => void {\n  let unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);\n  const rebindModes = () => {\n    unsubscribeModes?.();\n    unsubscribeModes = fileLinkModes?.subscribe(sessionId, listener);\n    listener();\n  };\n  modeBindings.add(rebindModes);\n  let subscriptions: (() => void)[] = [];\n  const unsubscribeSources = (): void => {\n    subscriptions.forEach((unsubscribe) => unsubscribe());\n    subscriptions = [];\n  };\n  const subscribeSources = (): void => {\n    subscriptions = pluginFileLinks().map((source) => source.subscribe(listener));\n  };\n  subscribeSources();\n  const unsubscribeRegistry = subscribeWebPluginRegistry(() => {\n    unsubscribeSources();\n    subscribeSources();\n    listener();\n  });\n  return () => {\n    modeBindings.delete(rebindModes);\n    unsubscribeModes?.();\n    unsubscribeRegistry();\n    unsubscribeSources();\n  };\n}\n\nfunction activeFileLinkSources(sessionId: string | null) {\n  const enabled = new Set(fileLinkModes?.active(sessionId) ?? []);\n  return pluginFileLinks().filter(\n    (source) => source.requiredMinorMode === undefined || enabled.has(source.requiredMinorMode),\n  );\n}\n\nfunction fileLinkFingerprint(sessionId: string | null): string {\n  const sourceFingerprints = activeFileLinkSources(sessionId)\n    .map((source) => `${source.requiredMinorMode ?? ''}:${source.fingerprint(sessionId)}`)\n    .join('\\n');\n  return `${webPluginRegistryRevision()}:${sourceFingerprints}`;\n}\n\n/**\n * The tab a path opens, from the first source that claims it.\n *\n * A path no source claims is not a link. The host cannot tell a file name from\n * a class name, and the plugin that tracks the session's files can, so the\n * decision belongs there rather than in a heuristic here.\n */\nexport function fileLinkFor(sessionId: string | null, path: string): TransientTab | undefined {\n  for (const source of activeFileLinkSources(sessionId)) {\n    const tab = source.resolve(sessionId, path);\n    if (tab !== undefined) return tab;\n  }\n  return undefined;\n}\n\n/**\n * The tab a path the caller is sure about opens: a tool call's path argument,\n * not a token spotted in prose.\n *\n * A source that offers `openPath` answers here, and it may claim a file the\n * session never changed, which `resolve` deliberately will not. Sources\n * without it fall back to the same guess prose gets.\n */\nexport function fileTabForPath(sessionId: string | null, path: string): TransientTab | undefined {\n  for (const source of activeFileLinkSources(sessionId)) {\n    const tab = source.openPath?.(sessionId, path) ?? source.resolve(sessionId, path);\n    if (tab !== undefined) return tab;\n  }\n  return undefined;\n}\n/**\n * Resolves the paths a message names against the plugins that track them.\n *\n * The resolver's identity is stable while the linkable set is, so a component\n * that hands it to a renderer does not rebuild that renderer on every frame of\n * a streaming reply.\n */\nexport function useFileLinks(sessionId: string | null): FileLinkResolver {\n  const fingerprint = useSyncExternalStore(\n    useCallback((listener: () => void) => subscribeFileLinks(sessionId, listener), [sessionId]),\n    () => fileLinkFingerprint(sessionId),\n    () => fileLinkFingerprint(sessionId),\n  );\n  return useCallback(\n    (path: string) => fileLinkFor(sessionId, path),\n    // The fingerprint is the dependency: the same path resolves differently\n    // once the session's set of tracked files changes.\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- fingerprint is a deliberate identity buster, not a value the callback reads.\n    [sessionId, fingerprint],\n  );\n}\n"],"mappings":"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"}

package/dist/web/lib/contextComposition.cjs

@@ -0,0 +1,132 @@
+const require_statusLine = require("./statusLine.cjs");
+const require_composition = require("./composition.cjs");
+//#region src/web/lib/contextComposition.ts
+/** Extensions first: they are the session's own, and the eye starts there. */
+const SOURCE_ORDER = {
+	extension: 0,
+	mcp: 1,
+	plugin: 2,
+	core: 3
+};
+const KIND_ORDER = {
+	major: 0,
+	minor: 1,
+	domain: 2,
+	core: 3
+};
+function bySource(left, right) {
+	return SOURCE_ORDER[left.source] - SOURCE_ORDER[right.source] || left.name.localeCompare(right.name);
+}
+/** A group with nothing priced reports null rather than a confident zero. */
+function subtotal(items) {
+	const priced = items.filter((item) => item.tokens !== null);
+	return priced.length === 0 ? null : priced.reduce((total, item) => total + (item.tokens ?? 0), 0);
+}
+function group(id, label, kind, detail, items) {
+	const sorted = [...items].sort(bySource);
+	return {
+		id,
+		label,
+		kind,
+		detail,
+		items: sorted,
+		tokens: subtotal(sorted),
+		inactiveTokens: 0
+	};
+}
+/**
+* The composition the session is running under.
+*
+* Until the runtime publishes its inventory every group is empty, which is the
+* honest reading: the modes are known from the footer the session already
+* publishes, the tools they brought are not.
+*/
+function contextGroups(statuses, widgets, projection = null, items = [], attribution = {}) {
+	const selection = require_statusLine.parseSelection(statuses["doom-major-mode"] ?? "");
+	const byGroup = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const key = attribution[item.name] ?? "core";
+		const bucket = byGroup.get(key);
+		if (bucket) bucket.push(item);
+		else byGroup.set(key, [item]);
+	}
+	const take = (key) => byGroup.get(key) ?? [];
+	const groups = [];
+	if (selection.majorMode) groups.push(group(selection.majorMode, selection.majorMode, "major", selection.pending ? "switching" : "", take(selection.majorMode)));
+	for (const mode of require_composition.minorModes(statuses, widgets, projection)) {
+		if (mode.availability !== "on") continue;
+		groups.push(group(mode.id, mode.name, "minor", mode.detail, take(mode.id)));
+	}
+	for (const domain of [...selection.domains].sort((left, right) => left.localeCompare(right))) groups.push(group(domain, domain, "domain", "", take(domain)));
+	const orphans = take("core");
+	if (orphans.length > 0) groups.push(group("core", "core", "core", "", orphans));
+	return groups.sort((left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind]);
+}
+/**
+* The runtime's own grouping, used as published.
+*
+* Once the session reports a composition it already knows which mode admitted
+* each tool, which is a join the page cannot make for itself. Re-deriving it
+* here from status strings would only be able to disagree.
+*/
+function projectedGroups(projection) {
+	return projection.groups.map((group) => ({
+		id: group.id,
+		label: group.label,
+		kind: group.kind,
+		detail: "",
+		inactiveTokens: group.inactiveTokens,
+		items: group.items.map((item) => ({
+			name: item.name,
+			itemKind: item.itemKind,
+			source: item.source,
+			owner: item.owner,
+			tokens: item.tokens,
+			active: item.active
+		})),
+		tokens: group.tokens
+	}));
+}
+/** The whole composition's estimate, or null while nothing is priced. */
+function totalTokens(groups) {
+	const priced = groups.filter((entry) => entry.tokens !== null);
+	return priced.length === 0 ? null : priced.reduce((total, entry) => total + (entry.tokens ?? 0), 0);
+}
+/** The scope is noise once the rows beneath already name the package. */
+function ownerLabel(owner) {
+	return owner.startsWith("@") ? owner.split("/").pop() ?? owner : owner;
+}
+function ownersOf(group) {
+	const byOwner = /* @__PURE__ */ new Map();
+	for (const item of group.items) {
+		const existing = byOwner.get(item.owner);
+		if (existing) {
+			existing.items.push(item);
+			existing.tokens += item.active ? item.tokens ?? 0 : 0;
+			existing.inactiveTokens += item.active ? 0 : item.tokens ?? 0;
+			continue;
+		}
+		byOwner.set(item.owner, {
+			owner: item.owner,
+			source: item.source,
+			items: [item],
+			tokens: item.active ? item.tokens ?? 0 : 0,
+			inactiveTokens: item.active ? 0 : item.tokens ?? 0
+		});
+	}
+	for (const entry of byOwner.values()) entry.items.sort((left, right) => left.name.localeCompare(right.name));
+	return [...byOwner.values()].sort((left, right) => SOURCE_ORDER[left.source] - SOURCE_ORDER[right.source] || ownerLabel(left.owner).localeCompare(ownerLabel(right.owner)));
+}
+/** What every gated item across the composition would add if switched on. */
+function inactiveTotal(groups) {
+	return groups.reduce((total, entry) => total + entry.inactiveTokens, 0);
+}
+//#endregion
+exports.contextGroups = contextGroups;
+exports.inactiveTotal = inactiveTotal;
+exports.ownerLabel = ownerLabel;
+exports.ownersOf = ownersOf;
+exports.projectedGroups = projectedGroups;
+exports.totalTokens = totalTokens;
+
+//# sourceMappingURL=contextComposition.cjs.map

package/dist/web/lib/contextComposition.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextComposition.cjs","names":["parseSelection","minorModes"],"sources":["../../../src/web/lib/contextComposition.ts"],"sourcesContent":["import type { ContextProjection, MinorModeProjection } from '../../types/hub';\nimport { minorModes } from './composition';\nimport { parseSelection } from './statusLine';\n\n/**\n * What the session is composed of, as opposed to what it is doing.\n *\n * The activity dock answers \"what is running\"; this answers \"what is loaded and\n * what does carrying it cost\". A group is a mode, because a mode is the thing a\n * reader can actually switch off: grouping by source would name the mechanism\n * rather than the decision. Rows inside a group are ordered by source kind so\n * the session's own extensions read before anything a server or plugin added.\n */\nexport type ContextGroupKind = 'major' | 'minor' | 'domain' | 'core';\n\nexport type ContextItemSource = 'extension' | 'mcp' | 'plugin' | 'core';\n\n/** Extensions first: they are the session's own, and the eye starts there. */\nconst SOURCE_ORDER: Record<ContextItemSource, number> = { extension: 0, mcp: 1, plugin: 2, core: 3 };\n\nconst KIND_ORDER: Record<ContextGroupKind, number> = { major: 0, minor: 1, domain: 2, core: 3 };\n\nexport interface ContextItem {\n  name: string;\n  itemKind: 'tool' | 'skill';\n  source: ContextItemSource;\n  /** The package or server that registered it. */\n  owner: string;\n  /** Estimated tokens, or null while the runtime has not reported a figure. */\n  tokens: number | null;\n  active: boolean;\n}\n\nexport interface ContextGroup {\n  id: string;\n  label: string;\n  kind: ContextGroupKind;\n  /** A short qualifier shown beside the label, e.g. a pending switch. */\n  detail: string;\n  items: ContextItem[];\n  /** Subtotal across active items, or null when no item carries a figure. */\n  tokens: number | null;\n  /** What the group's gated items would add if switched on. */\n  inactiveTokens: number;\n}\n\nfunction bySource(left: ContextItem, right: ContextItem): number {\n  return SOURCE_ORDER[left.source] - SOURCE_ORDER[right.source] || left.name.localeCompare(right.name);\n}\n\n/** A group with nothing priced reports null rather than a confident zero. */\nfunction subtotal(items: readonly ContextItem[]): number | null {\n  const priced = items.filter((item) => item.tokens !== null);\n  return priced.length === 0 ? null : priced.reduce((total, item) => total + (item.tokens ?? 0), 0);\n}\n\nfunction group(id: string, label: string, kind: ContextGroupKind, detail: string, items: ContextItem[]): ContextGroup {\n  const sorted = [...items].sort(bySource);\n  return { id, label, kind, detail, items: sorted, tokens: subtotal(sorted), inactiveTokens: 0 };\n}\n\n/**\n * The composition the session is running under.\n *\n * Until the runtime publishes its inventory every group is empty, which is the\n * honest reading: the modes are known from the footer the session already\n * publishes, the tools they brought are not.\n */\nexport function contextGroups(\n  statuses: Record<string, string>,\n  widgets: readonly string[],\n  projection: MinorModeProjection | null = null,\n  items: readonly ContextItem[] = [],\n  attribution: Readonly<Record<string, string>> = {},\n): ContextGroup[] {\n  const selection = parseSelection(statuses['doom-major-mode'] ?? '');\n  const byGroup = new Map<string, ContextItem[]>();\n  for (const item of items) {\n    const key = attribution[item.name] ?? 'core';\n    const bucket = byGroup.get(key);\n    if (bucket) bucket.push(item);\n    else byGroup.set(key, [item]);\n  }\n  const take = (key: string): ContextItem[] => byGroup.get(key) ?? [];\n\n  const groups: ContextGroup[] = [];\n\n  if (selection.majorMode) {\n    groups.push(\n      group(\n        selection.majorMode,\n        selection.majorMode,\n        'major',\n        selection.pending ? 'switching' : '',\n        take(selection.majorMode),\n      ),\n    );\n  }\n\n  for (const mode of minorModes(statuses, widgets, projection)) {\n    if (mode.availability !== 'on') continue;\n    groups.push(group(mode.id, mode.name, 'minor', mode.detail, take(mode.id)));\n  }\n\n  for (const domain of [...selection.domains].sort((left, right) => left.localeCompare(right))) {\n    groups.push(group(domain, domain, 'domain', '', take(domain)));\n  }\n\n  // Pi's own tools, and anything the runtime could not attribute. An\n  // unattributed tool is still costing context, so it is listed rather than\n  // dropped for failing to name a sponsor.\n  const orphans = take('core');\n  if (orphans.length > 0) groups.push(group('core', 'core', 'core', '', orphans));\n\n  return groups.sort((left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind]);\n}\n\n/**\n * The runtime's own grouping, used as published.\n *\n * Once the session reports a composition it already knows which mode admitted\n * each tool, which is a join the page cannot make for itself. Re-deriving it\n * here from status strings would only be able to disagree.\n */\nexport function projectedGroups(projection: ContextProjection): ContextGroup[] {\n  return projection.groups.map((group) => ({\n    id: group.id,\n    label: group.label,\n    kind: group.kind,\n    detail: '',\n    inactiveTokens: group.inactiveTokens,\n    items: group.items.map((item) => ({\n      name: item.name,\n      itemKind: item.itemKind,\n      source: item.source,\n      owner: item.owner,\n      tokens: item.tokens,\n      active: item.active,\n    })),\n    tokens: group.tokens,\n  }));\n}\n\n/** The whole composition's estimate, or null while nothing is priced. */\nexport function totalTokens(groups: readonly ContextGroup[]): number | null {\n  const priced = groups.filter((entry) => entry.tokens !== null);\n  return priced.length === 0 ? null : priced.reduce((total, entry) => total + (entry.tokens ?? 0), 0);\n}\n\n/**\n * One package, server, or plugin inside a mode, with what it costs.\n *\n * A mode can admit two dozen tools from a dozen packages, and a flat list of\n * those names says nothing about which dependency to reconsider. The package is\n * the unit that gets added or removed, so it is the unit worth totalling.\n */\nexport interface ContextOwner {\n  owner: string;\n  /** Every tool a single owner registers shares one source kind. */\n  source: ContextItemSource;\n  items: ContextItem[];\n  tokens: number;\n  inactiveTokens: number;\n}\n\n/** The scope is noise once the rows beneath already name the package. */\nexport function ownerLabel(owner: string): string {\n  return owner.startsWith('@') ? (owner.split('/').pop() ?? owner) : owner;\n}\n\nexport function ownersOf(group: ContextGroup): ContextOwner[] {\n  const byOwner = new Map<string, ContextOwner>();\n  for (const item of group.items) {\n    const existing = byOwner.get(item.owner);\n    if (existing) {\n      existing.items.push(item);\n      existing.tokens += item.active ? (item.tokens ?? 0) : 0;\n      existing.inactiveTokens += item.active ? 0 : (item.tokens ?? 0);\n      continue;\n    }\n    byOwner.set(item.owner, {\n      owner: item.owner,\n      source: item.source,\n      items: [item],\n      tokens: item.active ? (item.tokens ?? 0) : 0,\n      inactiveTokens: item.active ? 0 : (item.tokens ?? 0),\n    });\n  }\n  for (const entry of byOwner.values()) entry.items.sort((left, right) => left.name.localeCompare(right.name));\n  return [...byOwner.values()].sort(\n    (left, right) =>\n      SOURCE_ORDER[left.source] - SOURCE_ORDER[right.source] ||\n      ownerLabel(left.owner).localeCompare(ownerLabel(right.owner)),\n  );\n}\n\n/** What every gated item across the composition would add if switched on. */\nexport function inactiveTotal(groups: readonly ContextGroup[]): number {\n  return groups.reduce((total, entry) => total + entry.inactiveTokens, 0);\n}\n"],"mappings":";;;;AAkBA,MAAM,eAAkD;CAAE,WAAW;CAAG,KAAK;CAAG,QAAQ;CAAG,MAAM;AAAE;AAEnG,MAAM,aAA+C;CAAE,OAAO;CAAG,OAAO;CAAG,QAAQ;CAAG,MAAM;AAAE;AA0B9F,SAAS,SAAS,MAAmB,OAA4B;CAC/D,OAAO,aAAa,KAAK,UAAU,aAAa,MAAM,WAAW,KAAK,KAAK,cAAc,MAAM,IAAI;AACrG;;AAGA,SAAS,SAAS,OAA8C;CAC9D,MAAM,SAAS,MAAM,QAAQ,SAAS,KAAK,WAAW,IAAI;CAC1D,OAAO,OAAO,WAAW,IAAI,OAAO,OAAO,QAAQ,OAAO,SAAS,SAAS,KAAK,UAAU,IAAI,CAAC;AAClG;AAEA,SAAS,MAAM,IAAY,OAAe,MAAwB,QAAgB,OAAoC;CACpH,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,QAAQ;CACvC,OAAO;EAAE;EAAI;EAAO;EAAM;EAAQ,OAAO;EAAQ,QAAQ,SAAS,MAAM;EAAG,gBAAgB;CAAE;AAC/F;;;;;;;;AASA,SAAgB,cACd,UACA,SACA,aAAyC,MACzC,QAAgC,CAAC,GACjC,cAAgD,CAAC,GACjC;CAChB,MAAM,YAAYA,mBAAAA,eAAe,SAAS,sBAAsB,EAAE;CAClE,MAAM,0BAAU,IAAI,IAA2B;CAC/C,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,MAAM,YAAY,KAAK,SAAS;EACtC,MAAM,SAAS,QAAQ,IAAI,GAAG;EAC9B,IAAI,QAAQ,OAAO,KAAK,IAAI;OACvB,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;CAC9B;CACA,MAAM,QAAQ,QAA+B,QAAQ,IAAI,GAAG,KAAK,CAAC;CAElE,MAAM,SAAyB,CAAC;CAEhC,IAAI,UAAU,WACZ,OAAO,KACL,MACE,UAAU,WACV,UAAU,WACV,SACA,UAAU,UAAU,cAAc,IAClC,KAAK,UAAU,SAAS,CAC1B,CACF;CAGF,KAAK,MAAM,QAAQC,oBAAAA,WAAW,UAAU,SAAS,UAAU,GAAG;EAC5D,IAAI,KAAK,iBAAiB,MAAM;EAChC,OAAO,KAAK,MAAM,KAAK,IAAI,KAAK,MAAM,SAAS,KAAK,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;CAC5E;CAEA,KAAK,MAAM,UAAU,CAAC,GAAG,UAAU,OAAO,CAAC,CAAC,MAAM,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC,GACzF,OAAO,KAAK,MAAM,QAAQ,QAAQ,UAAU,IAAI,KAAK,MAAM,CAAC,CAAC;CAM/D,MAAM,UAAU,KAAK,MAAM;CAC3B,IAAI,QAAQ,SAAS,GAAG,OAAO,KAAK,MAAM,QAAQ,QAAQ,QAAQ,IAAI,OAAO,CAAC;CAE9E,OAAO,OAAO,MAAM,MAAM,UAAU,WAAW,KAAK,QAAQ,WAAW,MAAM,KAAK;AACpF;;;;;;;;AASA,SAAgB,gBAAgB,YAA+C;CAC7E,OAAO,WAAW,OAAO,KAAK,WAAW;EACvC,IAAI,MAAM;EACV,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,QAAQ;EACR,gBAAgB,MAAM;EACtB,OAAO,MAAM,MAAM,KAAK,UAAU;GAChC,MAAM,KAAK;GACX,UAAU,KAAK;GACf,QAAQ,KAAK;GACb,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,QAAQ,KAAK;EACf,EAAE;EACF,QAAQ,MAAM;CAChB,EAAE;AACJ;;AAGA,SAAgB,YAAY,QAAgD;CAC1E,MAAM,SAAS,OAAO,QAAQ,UAAU,MAAM,WAAW,IAAI;CAC7D,OAAO,OAAO,WAAW,IAAI,OAAO,OAAO,QAAQ,OAAO,UAAU,SAAS,MAAM,UAAU,IAAI,CAAC;AACpG;;AAmBA,SAAgB,WAAW,OAAuB;CAChD,OAAO,MAAM,WAAW,GAAG,IAAK,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,QAAS;AACrE;AAEA,SAAgB,SAAS,OAAqC;CAC5D,MAAM,0BAAU,IAAI,IAA0B;CAC9C,KAAK,MAAM,QAAQ,MAAM,OAAO;EAC9B,MAAM,WAAW,QAAQ,IAAI,KAAK,KAAK;EACvC,IAAI,UAAU;GACZ,SAAS,MAAM,KAAK,IAAI;GACxB,SAAS,UAAU,KAAK,SAAU,KAAK,UAAU,IAAK;GACtD,SAAS,kBAAkB,KAAK,SAAS,IAAK,KAAK,UAAU;GAC7D;EACF;EACA,QAAQ,IAAI,KAAK,OAAO;GACtB,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,OAAO,CAAC,IAAI;GACZ,QAAQ,KAAK,SAAU,KAAK,UAAU,IAAK;GAC3C,gBAAgB,KAAK,SAAS,IAAK,KAAK,UAAU;EACpD,CAAC;CACH;CACA,KAAK,MAAM,SAAS,QAAQ,OAAO,GAAG,MAAM,MAAM,MAAM,MAAM,UAAU,KAAK,KAAK,cAAc,MAAM,IAAI,CAAC;CAC3G,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,MAC1B,MAAM,UACL,aAAa,KAAK,UAAU,aAAa,MAAM,WAC/C,WAAW,KAAK,KAAK,CAAC,CAAC,cAAc,WAAW,MAAM,KAAK,CAAC,CAChE;AACF;;AAGA,SAAgB,cAAc,QAAyC;CACrE,OAAO,OAAO,QAAQ,OAAO,UAAU,QAAQ,MAAM,gBAAgB,CAAC;AACxE"}