zidane-ui 9.0.4 → 9.1.3

package/dist/extensions/headless/host.d.ts

@@ -0,0 +1,433 @@
+import { Readable } from "../../chat/headless/store.js";
+import { DialogRequestWire, ExtensionItem, ExtensionTokenName, WebviewWire, WireSettings } from "./wire.js";
+import { BadgeActionEffect, BadgeMenuItem, BadgeTarget, CatalogItemProvenance, CatalogKind, ExtensionBadgeIcon, ExtensionReferenceView, PanelContent, PanelFocus } from "zidane/chat/pure";
+//#region src/extensions/headless/host.d.ts
+/** Why a host call failed, for the UI to word through its labels. */
+type ExtensionsError =
+/** The host cannot do it (the extension unloaded, the connection dropped, not offered here). */
+{
+  code: 'unavailable';
+} |
+/** It ran and failed; `message` is the extension's own words. */
+{
+  code: 'failed';
+  message: string;
+} |
+/** An RPC method answered an error: a declared error name (or a reserved `rpc.*` type), its words and data. */
+{
+  code: 'rpc';
+  type: string;
+  message: string;
+  data?: unknown;
+} |
+/** The host refused: a locked setting, an invalid value, a contract the caller may not use. */
+{
+  code: 'refused';
+  reason: 'locked' | 'invalid' | 'not-allowed';
+  message?: string;
+};
+/** What a host action rejects with. */
+declare class ExtensionsHostError extends Error {
+  readonly error: ExtensionsError;
+  /**
+   * @param error - Why it failed.
+   */
+  constructor(error: ExtensionsError);
+}
+/**
+ * The typed error behind any rejection: an {@link ExtensionsHostError}'s own, else `failed` with the message.
+ *
+ * @param err - What a host action rejected with.
+ */
+declare function extensionsErrorOf(err: unknown): ExtensionsError;
+/** The extension callbacks a host can invoke, by id: their arguments and what they answer. */
+interface ExtensionCallbacks {
+  /** A panel's `load` in a folder. */
+  'panel.load': {
+    args: {
+      panelId: string;
+      cwd: string;
+      context?: unknown;
+    };
+    result: PanelContent;
+  };
+  /** A panel's `onAction`. Whether it ran. */
+  'panel.action': {
+    args: {
+      panelId: string;
+      actionId: string;
+      payload?: unknown;
+      cwd: string;
+      context?: unknown;
+    };
+    result: boolean;
+  };
+  /** A reference provider's `resolve`. `null`: nothing to show. */
+  'reference.resolve': {
+    args: {
+      providerId: string;
+      key: string;
+    };
+    result: ExtensionReferenceView | null;
+  };
+  /** The badge action menu for a target. */
+  'badge.menu': {
+    args: {
+      target: BadgeTarget;
+    };
+    result: readonly BadgeMenuItem[];
+  };
+  /** Runs one badge action. */
+  'badge.run': {
+    args: {
+      source: string;
+      actionId: string;
+      target: BadgeTarget;
+      sessionId?: string;
+      cwd?: string;
+    };
+    result: BadgeActionEffect;
+  };
+  /** Runs an action setting of a settings page (or of an extension's settings: `pageId` is then the extension id). */
+  'setting.action': {
+    args: {
+      pageId: string;
+      key: string;
+    };
+    result: {
+      message?: string;
+      tone?: 'info' | 'success' | 'warn' | 'error';
+      patch?: Readonly<Record<string, string | number | boolean | readonly string[]>>;
+    } | undefined;
+  };
+  /** An action setting's passive status line. */
+  'setting.status': {
+    args: {
+      pageId: string;
+      key: string;
+    };
+    result: {
+      text: string;
+      tone?: 'muted' | 'success' | 'warn' | 'error';
+    } | undefined;
+  };
+}
+/** A callback id. */
+type ExtensionCallbackId = keyof ExtensionCallbacks;
+/** The items of every token, each a store. */
+type ExtensionItemStores = { readonly [N in ExtensionTokenName]: Readable<readonly ExtensionItem<N>[]>; };
+/** A dialog waiting on the user. */
+interface ExtensionDialog {
+  /** Unique per dialog: answers name it. */
+  id: string;
+  /** The extension asking. */
+  extensionId: string;
+  /** The session it is about. */
+  sessionId?: string;
+  /** What to show. */
+  request: DialogRequestWire;
+}
+/**
+ * `ctx.ui` dialogs routed to this client. A dialog the extension withdraws (timeout, abort) leaves the
+ * stores without an answer.
+ */
+interface ExtensionDialogs {
+  /** The dialog to show now (the oldest non-toast one), or `null`. */
+  current: Readable<ExtensionDialog | null>;
+  /** The toasts showing now, oldest first. */
+  toasts: Readable<readonly ExtensionDialog[]>;
+  /**
+   * Answers a dialog. The answer per kind: `confirm` a boolean, `prompt` the text, `select`
+   * `{ ids, action? }`, `form` a value per key, `askUser` a `QuestionResponse`, `presentPlan` a
+   * `PlanResponse`, `toast` the clicked action id. `undefined` cancels (or dismisses a toast).
+   */
+  answer(id: string, answer: unknown): Promise<void>;
+}
+/** A file `ctx.composer.attach` sends: a path, or bytes in base64. */
+type ExtensionComposerFile = {
+  path: string;
+} | {
+  name: string;
+  mimeType: string;
+  data: string;
+};
+/** Where `ctx.ui.navigate` goes. Screen ids are full (`<extension>/<id>`). */
+type ExtensionNavigateTarget = {
+  screen: string;
+} | {
+  session: string;
+} | {
+  newSession: true;
+};
+/** One `ctx.ui` / `ctx.composer` call for the app to apply: zidane's `UiClientPort` calls. */
+type ExtensionUiEffect =
+/** Open, close or toggle a panel (full id or built-in tab). Settle with whether it did. */
+{
+  kind: 'panel';
+  action: 'open' | 'close' | 'toggle';
+  panelId: string;
+  sessionId?: string;
+  focus?: PanelFocus;
+} |
+/** Which panels are open (beside `sessionId`). Settle with the panel ids. */
+{
+  kind: 'panel-state';
+  sessionId?: string;
+} |
+/** Show a screen, a session, or a new session. Settle with whether it did. */
+{
+  kind: 'navigate';
+  to: ExtensionNavigateTarget;
+} |
+/** Edit the composer (the one for `sessionId`). Settle with whether it did. */
+{
+  kind: 'composer';
+  op: {
+    op: 'insert';
+    text: string;
+  } | {
+    op: 'setText';
+    text: string;
+  } | {
+    op: 'attach';
+    files: readonly ExtensionComposerFile[];
+  };
+  sessionId?: string;
+} |
+/** An OS notification, unless the app has focus. Nothing to settle. */
+{
+  kind: 'notify';
+  title: string;
+  body?: string;
+  sound?: boolean;
+  sessionId?: string;
+  extensionId: string;
+} |
+/**
+ * Press `chord` (`'mod+k'`, `mod` unresolved: ⌘ on macOS, Ctrl elsewhere) as if the user typed it, in the
+ * view of `sessionId` when given (`ctx.keymap.dispatch`). Settle with whether a binding took it.
+ */
+{
+  kind: 'keymap';
+  chord: string;
+  sessionId?: string;
+};
+/** An effect and the id its result goes back under. */
+interface ExtensionUiEffectRequest {
+  /** Names the effect in {@link ExtensionUiEffects.settle}. */
+  id: string;
+  /** What to apply. */
+  effect: ExtensionUiEffect;
+}
+/** The `ctx.ui` / `ctx.composer` calls routed to this client, for the app to apply. */
+interface ExtensionUiEffects {
+  /** Calls `listener` for each effect, in order. Returns the unsubscribe. */
+  subscribe(listener: (request: ExtensionUiEffectRequest) => void): () => void;
+  /** Reports what applying an effect gave (`boolean`, or the panel ids for `panel-state`). */
+  settle(id: string, result: boolean | readonly string[]): void;
+}
+/** One typed store of an extension (`ctx.storage.store`). */
+interface ExtensionStoreRef {
+  /** The extension that owns the store. */
+  extensionId: string;
+  /** The store's name. */
+  name: string;
+  /** Where the store keeps its value: for the user, the project or one session. */
+  scope: 'user' | 'project' | 'session';
+  /** For `session` scope. */
+  sessionId?: string;
+}
+/** The extensions' typed stores, as the UI reads and writes them. */
+interface ExtensionStorage {
+  /** The store's value (`undefined` until known or when nothing is stored). Same ref, same store. */
+  store(ref: ExtensionStoreRef): Readable<unknown>;
+  /** Writes the store's value. The extension validates it; a refusal rejects (`refused` / `invalid`). */
+  set(ref: ExtensionStoreRef, value: unknown): Promise<void>;
+}
+/** Who changed a catalog item (Settings shows it): zidane's `CatalogItemProvenance`, with the catalog it is in. */
+interface ExtensionProvenanceWire extends CatalogItemProvenance {
+  /** The catalog the item is in. */
+  kind: CatalogKind;
+}
+/** Every extension's settings, as Settings draws them. */
+interface ExtensionSettingsWire extends WireSettings {
+  /** The catalog items extensions changed. Absent: not reported by this host. */
+  provenance?: readonly ExtensionProvenanceWire[];
+}
+/** The extensions' settings. */
+interface ExtensionSettings {
+  /** The settings of every extension, merged. */
+  wire: Readable<ExtensionSettingsWire>;
+  /** Writes one value. Rejects `refused` (`locked`, `invalid`). Absent: read-only here. */
+  set?(extensionId: string, key: string, value: unknown): Promise<void>;
+}
+/** One account connected to an integration. */
+interface ExtensionIntegrationConnectionWire {
+  /** The method it connected through. */
+  methodId: string;
+  /** The account's stable id (`'default'` when the integration names none). */
+  account: string;
+  /** What to show for it. Absent: the account. */
+  label?: string;
+  /** The integration's default connection. */
+  isDefault?: boolean;
+  /** When it connected, in ms since the epoch. */
+  connectedAt: number;
+}
+/** An integration on the wire: its spec without callbacks, and its connections. */
+interface ExtensionIntegrationWire {
+  /** The integration's id. */
+  id: string;
+  /** What to show for it. */
+  name: string;
+  /** A line saying what it connects to. */
+  description?: string;
+  /** Its glyph. */
+  icon?: ExtensionBadgeIcon;
+  /** The extension that registered it. */
+  extensionId: string;
+  /** The ways to connect. */
+  methods: readonly {
+    type: 'apiKey' | 'oauth' | 'command' | 'custom';
+    id: string;
+    label: string;
+    placeholder?: string;
+    help?: string;
+  }[];
+  /** The default connection. Absent: not connected. */
+  connection?: ExtensionIntegrationConnectionWire;
+  /** Every connection, one per account, the default first. Absent: none. */
+  connections?: readonly ExtensionIntegrationConnectionWire[];
+}
+/** Integrations: Settings' Connect, Disconnect and default account. */
+interface ExtensionIntegrations {
+  /** Every integration with its connections. */
+  list: Readable<readonly ExtensionIntegrationWire[]>;
+  /**
+   * Adds a connection: with `key` through an `apiKey` method, else runs the method (the host shows its UI).
+   * The same account replaces its connection; the first one becomes the default.
+   */
+  connect(integrationId: string, opts: {
+    methodId: string;
+    key?: string;
+  }): Promise<void>;
+  /** Removes `account`'s connection, or every connection with no `account`. */
+  disconnect(integrationId: string, opts?: {
+    account?: string;
+  }): Promise<void>;
+  /** Makes `account`'s connection the default. */
+  setDefault(integrationId: string, account: string): Promise<void>;
+}
+/** A command on the wire: zidane's `CommandListing`, plus what a palette shows. */
+interface ExtensionCommandWire {
+  /** Published id: `<extension>.<id>`, or a built-in's. */
+  id: string;
+  /** What a palette shows for it. */
+  title: string;
+  /** A line under the title. */
+  description?: string;
+  /** The `/` name, without the slash. */
+  slash?: string;
+  /** Effective chords. */
+  bind?: readonly string[];
+  /** The registering extension; absent for a built-in. */
+  extensionId?: string;
+}
+/** The unified commands. */
+interface ExtensionCommands {
+  /** Every command, built-ins and extensions'. */
+  list: Readable<readonly ExtensionCommandWire[]>;
+  /** Runs one. Whether a command by that id ran. */
+  run(id: string, opts?: {
+    args?: string;
+    sessionId?: string;
+  }): Promise<boolean>;
+}
+/** Where the extensions' webviews load from: the app's origin policy, so every webview the kit draws follows it. */
+interface ExtensionWebviews {
+  /**
+   * The URL a webview loads (a `file` source made a URL the app serves), or `null`: not served here, or
+   * not yet (`subscribe` tells when it may have changed).
+   */
+  resolveSrc(webview: WebviewWire, extension: string): string | null;
+  /** Calls `listener` when a URL may have changed (one minted later). Returns the unsubscribe. */
+  subscribe?(listener: () => void): () => void;
+  /** The origin a page's messages must come from, and the target of replies. Default `'*'`. */
+  origin?: string;
+  /** The iframe's sandbox flags. Default `'allow-scripts allow-forms'`. */
+  sandbox?: string;
+}
+/** A panel that would load something new: its `subscribe` emitted, or its handle was updated. */
+interface ExtensionPanelChange {
+  /** The extension that owns the panel. */
+  extensionId: string;
+  /** The panel's full id (`<extension>/<id>`). */
+  panelId: string;
+  /** Set when only this session's content changed. */
+  sessionId?: string;
+}
+/** Where a link was clicked: zidane's `LinkSource`. */
+type ExtensionLinkSource = 'transcript' | 'chip' | 'panel' | 'badge' | 'terminal' | 'other';
+/** A link the user opened, as {@link ExtensionsHost.openLink} offers it to the extensions' link handlers. */
+interface ExtensionLinkRequest {
+  /** The link as clicked (a URL, or a path a file chip names). */
+  url: string;
+  /** Where it was clicked. */
+  source: ExtensionLinkSource;
+  /** The session it was clicked in. */
+  sessionId?: string;
+}
+/**
+ * The least client token scope that may run something (`chat` ⊂ `approve` ⊂ `admin`): zidane's
+ * `AccessScope`, the scope of an action setting.
+ */
+type ExtensionAccessScope = 'chat' | 'approve' | 'admin';
+/** Options of {@link ExtensionsHost.rpc}. */
+interface ExtensionRpcOptions {
+  /** The extension whose UI calls: its own contracts count as local (internal methods allowed). */
+  extensionId?: string;
+  /** Aborts the call: it rejects as aborted. */
+  signal?: AbortSignal;
+}
+/** The extensions host. */
+interface ExtensionsHost {
+  /** Every contribution, per token. */
+  items: ExtensionItemStores;
+  /** Calls an extension callback by id. Absent: nothing invokes (panels don't load, menus stay empty). */
+  invoke?<K extends ExtensionCallbackId>(callbackId: K, args: ExtensionCallbacks[K]['args']): Promise<ExtensionCallbacks[K]['result']>;
+  /** `ctx.ui` dialogs and toasts routed to this client. Absent: this client shows none. */
+  dialogs?: ExtensionDialogs;
+  /** `ctx.ui` panels, navigation, composer edits and notifications routed to this client. */
+  effects?: ExtensionUiEffects;
+  /** Calls an RPC method. Rejects `rpc` with the method's error. Absent: no RPC from the UI. */
+  rpc?(contract: string, method: string, input?: unknown, opts?: ExtensionRpcOptions): Promise<unknown>;
+  /** The extensions' typed stores. */
+  storage?: ExtensionStorage;
+  /** The extensions' settings, locked keys and provenance included. */
+  settings?: ExtensionSettings;
+  /** Integrations and their connections. */
+  integrations?: ExtensionIntegrations;
+  /** The unified commands. */
+  commands?: ExtensionCommands;
+  /** Where webviews load from. Absent: a `url` source loads as given, a `file` source shows nothing. */
+  webviews?: ExtensionWebviews;
+  /**
+   * A panel would load something new (its `subscribe` emitted, or its handle was updated): reload it where
+   * visible. `sessionId`: only that session's content changed. Returns the unsubscribe. Absent: panels the kit
+   * draws reload only after an action or a folder change.
+   */
+  panelChanged?(listener: (change: ExtensionPanelChange) => void): () => void;
+  /**
+   * Offers a link the user opened to the extensions' link handlers (`LinkHandler`, higher `priority`
+   * first). Resolves `true` when one opened it; `false` (or a rejection): open it the app's way. The kit
+   * skips it while Alt is held (`routeLink`). Absent: links open the app's way.
+   */
+  openLink?(request: ExtensionLinkRequest): Promise<boolean>;
+  /**
+   * The scope this client's token grants (`null`: not limited, as a local or in-process host). Action
+   * settings above it show disabled with why. Absent: never limited.
+   */
+  scope?: Readable<ExtensionAccessScope | null>;
+}
+//#endregion
+export { ExtensionAccessScope, ExtensionCallbackId, ExtensionCallbacks, ExtensionCommandWire, ExtensionCommands, ExtensionComposerFile, ExtensionDialog, ExtensionDialogs, ExtensionIntegrationConnectionWire, ExtensionIntegrationWire, ExtensionIntegrations, ExtensionItemStores, ExtensionLinkRequest, ExtensionLinkSource, ExtensionNavigateTarget, ExtensionPanelChange, ExtensionProvenanceWire, ExtensionRpcOptions, ExtensionSettings, ExtensionSettingsWire, ExtensionStorage, ExtensionStoreRef, ExtensionUiEffect, ExtensionUiEffectRequest, ExtensionUiEffects, ExtensionWebviews, ExtensionsError, ExtensionsHost, ExtensionsHostError, extensionsErrorOf };

package/dist/extensions/headless/host.js

@@ -0,0 +1,27 @@
+//#region src/extensions/headless/host.ts
+/** What a host action rejects with. */
+var ExtensionsHostError = class extends Error {
+	error;
+	/**
+	* @param error - Why it failed.
+	*/
+	constructor(error) {
+		super(error.code === "failed" || error.code === "rpc" ? error.message : error.code === "refused" ? error.message ?? `refused: ${error.reason}` : "unavailable");
+		this.error = error;
+		this.name = "ExtensionsHostError";
+	}
+};
+/**
+* The typed error behind any rejection: an {@link ExtensionsHostError}'s own, else `failed` with the message.
+*
+* @param err - What a host action rejected with.
+*/
+function extensionsErrorOf(err) {
+	if (err instanceof ExtensionsHostError) return err.error;
+	return {
+		code: "failed",
+		message: err instanceof Error ? err.message : String(err)
+	};
+}
+//#endregion
+export { ExtensionsHostError, extensionsErrorOf };

package/dist/extensions/headless/index.d.ts

@@ -0,0 +1,10 @@
+import { BadgeActionWire, ComponentWire, ContextSectionWire, DialogKind, DialogRequestWire, EXTENSION_TOKENS, ExtensionItem, ExtensionTokenName, ExtensionWireMap, LinkHandlerWire, PanelWire, RendererTarget, RendererWire, SLOT_NAMES, ScreenWire, SelectOptionWire, SettingsPageWire, SidebarDecorationWire, SidebarFilterWire, SidebarGroupWire, SidebarRowActionWire, SidebarRowWire, SidebarSortWire, SlotName, SlotWire, SpaceWire, WebviewWire, WireSettings, WireSettingsPage } from "./wire.js";
+import { ExtensionAccessScope, ExtensionCallbackId, ExtensionCallbacks, ExtensionCommandWire, ExtensionCommands, ExtensionComposerFile, ExtensionDialog, ExtensionDialogs, ExtensionIntegrationConnectionWire, ExtensionIntegrationWire, ExtensionIntegrations, ExtensionItemStores, ExtensionLinkRequest, ExtensionLinkSource, ExtensionNavigateTarget, ExtensionPanelChange, ExtensionProvenanceWire, ExtensionRpcOptions, ExtensionSettings, ExtensionSettingsWire, ExtensionStorage, ExtensionStoreRef, ExtensionUiEffect, ExtensionUiEffectRequest, ExtensionUiEffects, ExtensionWebviews, ExtensionsError, ExtensionsHost, ExtensionsHostError, extensionsErrorOf } from "./host.js";
+import { ExtensionEffectApply, ExtensionEffectOutcome, ExtensionEffectRoute, ExtensionEffectRouter, createEffectRouter } from "./effect-router.js";
+import { DEFAULT_EXTENSIONS_LABELS, ExtensionsLabels } from "./labels.js";
+import { SettingValue, TITLEBAR_ITEMS_PER_EXTENSION, clampSettingNumber, filterSelectOptions, groupSelectOptions, isSettingLocked, missingScope, qualifyPanelId, rendererMatches, renderersFor, settingValue, settingsValues, slotIsActionable, slotItems, titlebarItems } from "./select.js";
+import { DialogQueue, DialogQueueShowContext, createDialogQueue } from "./dialog-queue.js";
+import { ExtensionUiEffectResult, UiEffectChannel, createUiEffectChannel } from "./effect-channel.js";
+import { LinkRouteOptions, openInNewTab, routeLink } from "./links.js";
+import { WEBVIEW_RPC_NOT_ALLOWED, WEBVIEW_RPC_REQUEST, WEBVIEW_RPC_RESULT, WEBVIEW_RPC_UNAVAILABLE, WebviewRpcBridge, WebviewRpcBridgeOptions, WebviewRpcRequest, WebviewRpcResult, createWebviewRpcBridge, isWebviewRpcRequest } from "./webview-bridge.js";
+export { BadgeActionWire, ComponentWire, ContextSectionWire, DEFAULT_EXTENSIONS_LABELS, DialogKind, DialogQueue, DialogQueueShowContext, DialogRequestWire, EXTENSION_TOKENS, ExtensionAccessScope, ExtensionCallbackId, ExtensionCallbacks, ExtensionCommandWire, ExtensionCommands, ExtensionComposerFile, ExtensionDialog, ExtensionDialogs, ExtensionEffectApply, ExtensionEffectOutcome, ExtensionEffectRoute, ExtensionEffectRouter, ExtensionIntegrationConnectionWire, ExtensionIntegrationWire, ExtensionIntegrations, ExtensionItem, ExtensionItemStores, ExtensionLinkRequest, ExtensionLinkSource, ExtensionNavigateTarget, ExtensionPanelChange, ExtensionProvenanceWire, ExtensionRpcOptions, ExtensionSettings, ExtensionSettingsWire, ExtensionStorage, ExtensionStoreRef, ExtensionTokenName, ExtensionUiEffect, ExtensionUiEffectRequest, ExtensionUiEffectResult, ExtensionUiEffects, ExtensionWebviews, ExtensionWireMap, ExtensionsError, ExtensionsHost, ExtensionsHostError, ExtensionsLabels, LinkHandlerWire, LinkRouteOptions, PanelWire, RendererTarget, RendererWire, SLOT_NAMES, ScreenWire, SelectOptionWire, SettingValue, SettingsPageWire, SidebarDecorationWire, SidebarFilterWire, SidebarGroupWire, SidebarRowActionWire, SidebarRowWire, SidebarSortWire, SlotName, SlotWire, SpaceWire, TITLEBAR_ITEMS_PER_EXTENSION, UiEffectChannel, WEBVIEW_RPC_NOT_ALLOWED, WEBVIEW_RPC_REQUEST, WEBVIEW_RPC_RESULT, WEBVIEW_RPC_UNAVAILABLE, WebviewRpcBridge, WebviewRpcBridgeOptions, WebviewRpcRequest, WebviewRpcResult, WebviewWire, WireSettings, WireSettingsPage, clampSettingNumber, createDialogQueue, createEffectRouter, createUiEffectChannel, createWebviewRpcBridge, extensionsErrorOf, filterSelectOptions, groupSelectOptions, isSettingLocked, isWebviewRpcRequest, missingScope, openInNewTab, qualifyPanelId, rendererMatches, renderersFor, routeLink, settingValue, settingsValues, slotIsActionable, slotItems, titlebarItems };

package/dist/extensions/headless/index.js

@@ -0,0 +1,10 @@
+import { createEffectRouter } from "./effect-router.js";
+import { DEFAULT_EXTENSIONS_LABELS } from "./labels.js";
+import { ExtensionsHostError, extensionsErrorOf } from "./host.js";
+import { WEBVIEW_RPC_NOT_ALLOWED, WEBVIEW_RPC_REQUEST, WEBVIEW_RPC_RESULT, WEBVIEW_RPC_UNAVAILABLE, createWebviewRpcBridge, isWebviewRpcRequest } from "./webview-bridge.js";
+import { openInNewTab, routeLink } from "./links.js";
+import { TITLEBAR_ITEMS_PER_EXTENSION, clampSettingNumber, filterSelectOptions, groupSelectOptions, isSettingLocked, missingScope, qualifyPanelId, rendererMatches, renderersFor, settingValue, settingsValues, slotIsActionable, slotItems, titlebarItems } from "./select.js";
+import { createDialogQueue } from "./dialog-queue.js";
+import { createUiEffectChannel } from "./effect-channel.js";
+import { EXTENSION_TOKENS, SLOT_NAMES } from "./wire.js";
+export { DEFAULT_EXTENSIONS_LABELS, EXTENSION_TOKENS, ExtensionsHostError, SLOT_NAMES, TITLEBAR_ITEMS_PER_EXTENSION, WEBVIEW_RPC_NOT_ALLOWED, WEBVIEW_RPC_REQUEST, WEBVIEW_RPC_RESULT, WEBVIEW_RPC_UNAVAILABLE, clampSettingNumber, createDialogQueue, createEffectRouter, createUiEffectChannel, createWebviewRpcBridge, extensionsErrorOf, filterSelectOptions, groupSelectOptions, isSettingLocked, isWebviewRpcRequest, missingScope, openInNewTab, qualifyPanelId, rendererMatches, renderersFor, routeLink, settingValue, settingsValues, slotIsActionable, slotItems, titlebarItems };

package/dist/extensions/headless/labels.d.ts

@@ -0,0 +1,45 @@
+import { ExtensionsError } from "./host.js";
+//#region src/extensions/headless/labels.d.ts
+/** The default English strings of the extensions components. */
+declare const DEFAULT_EXTENSIONS_LABELS: {
+  /** A slot item's running arc. */
+  extensionWorking: string;
+  /** A dialog's cancel button. */
+  extensionDialogCancel: string;
+  /** A confirm dialog's default confirm button. */
+  extensionDialogConfirm: string;
+  /** A prompt dialog's submit button. */
+  extensionDialogOk: string;
+  /** A multi select's done button. */
+  extensionDialogDone: string;
+  /** A form dialog's submit button. */
+  extensionDialogSubmit: string;
+  /** A select dialog's search field. */
+  extensionSelectSearch: string;
+  /** A select dialog with nothing matching the search. */
+  extensionSelectNoMatch: string;
+  /** Dismisses a toast. */
+  extensionToastDismiss: string;
+  /** The toasts' live region. */
+  extensionToasts: string;
+  /** A setting a declarative config entry sets. */
+  extensionSettingLocked: string;
+  /** An action setting's button. */
+  extensionSettingRun: string;
+  /** An action setting running. */
+  extensionSettingRunning: string;
+  /** A settings page or form with no rows. */
+  extensionSettingsNone: string;
+  /** A screen whose id no extension offers (any more). */
+  extensionScreenMissing: string;
+  /** Closes a screen. */
+  extensionScreenClose: string;
+  /** Names an extension's region in an error fallback. */
+  extensionRegion: (extension: string) => string;
+  /** Words a failed host call. */
+  extensionError: (error: ExtensionsError) => string;
+};
+/** The shape of the extensions label dictionary. */
+type ExtensionsLabels = typeof DEFAULT_EXTENSIONS_LABELS;
+//#endregion
+export { DEFAULT_EXTENSIONS_LABELS, ExtensionsLabels };

package/dist/extensions/headless/labels.js

@@ -0,0 +1,49 @@
+//#region src/extensions/headless/labels.ts
+/** The default English strings of the extensions components. */
+const DEFAULT_EXTENSIONS_LABELS = {
+	/** A slot item's running arc. */
+	extensionWorking: "Working",
+	/** A dialog's cancel button. */
+	extensionDialogCancel: "Cancel",
+	/** A confirm dialog's default confirm button. */
+	extensionDialogConfirm: "Confirm",
+	/** A prompt dialog's submit button. */
+	extensionDialogOk: "OK",
+	/** A multi select's done button. */
+	extensionDialogDone: "Done",
+	/** A form dialog's submit button. */
+	extensionDialogSubmit: "Save",
+	/** A select dialog's search field. */
+	extensionSelectSearch: "Search",
+	/** A select dialog with nothing matching the search. */
+	extensionSelectNoMatch: "Nothing matches",
+	/** Dismisses a toast. */
+	extensionToastDismiss: "Dismiss",
+	/** The toasts' live region. */
+	extensionToasts: "Notifications",
+	/** A setting a declarative config entry sets. */
+	extensionSettingLocked: "Set by the config file",
+	/** An action setting's button. */
+	extensionSettingRun: "Run",
+	/** An action setting running. */
+	extensionSettingRunning: "Running",
+	/** A settings page or form with no rows. */
+	extensionSettingsNone: "Nothing to set",
+	/** A screen whose id no extension offers (any more). */
+	extensionScreenMissing: "This screen is no longer available",
+	/** Closes a screen. */
+	extensionScreenClose: "Close",
+	/** Names an extension's region in an error fallback. */
+	extensionRegion: (extension) => `Extension ${extension}`,
+	/** Words a failed host call. */
+	extensionError: (error) => {
+		switch (error.code) {
+			case "unavailable": return "Not available right now";
+			case "failed":
+			case "rpc": return error.message;
+			case "refused": return error.reason === "locked" ? "Set by the config file" : error.reason === "invalid" ? error.message ?? "Not a valid value" : "Not allowed";
+		}
+	}
+};
+//#endregion
+export { DEFAULT_EXTENSIONS_LABELS };

package/dist/extensions/headless/links.d.ts

@@ -0,0 +1,30 @@
+import { ExtensionLinkSource, ExtensionsHost } from "./host.js";
+//#region src/extensions/headless/links.d.ts
+/** Where and how a link was opened. */
+interface LinkRouteOptions {
+  /** Where it was clicked. */
+  source: ExtensionLinkSource;
+  /** The session it was clicked in. */
+  sessionId?: string;
+  /** Opens it the app's way at once (the user held Alt). */
+  bypass?: boolean;
+}
+/**
+ * Opens `url`: through the extensions' link handlers first, else `fallback` (the app's own way).
+ * Resolves `true` when a handler opened it. A handler that fails counts as not opening it.
+ *
+ * @param openLink - The host's `openLink`. Absent: `fallback` at once.
+ * @param url - The link.
+ * @param options - Where it was clicked, the session, and whether to bypass the handlers.
+ * @param fallback - Opens the link the app's way.
+ */
+declare function routeLink(openLink: ExtensionsHost['openLink'], url: string, options: LinkRouteOptions, fallback: () => void): Promise<boolean>;
+/**
+ * Opens `url` in a new browser tab (in the desktop app, main's window-open handler hands it to the
+ * system): the app's way for a web link.
+ *
+ * @param url - The link.
+ */
+declare function openInNewTab(url: string): void;
+//#endregion
+export { LinkRouteOptions, openInNewTab, routeLink };

package/dist/extensions/headless/links.js

@@ -0,0 +1,34 @@
+//#region src/extensions/headless/links.ts
+/**
+* Opens `url`: through the extensions' link handlers first, else `fallback` (the app's own way).
+* Resolves `true` when a handler opened it. A handler that fails counts as not opening it.
+*
+* @param openLink - The host's `openLink`. Absent: `fallback` at once.
+* @param url - The link.
+* @param options - Where it was clicked, the session, and whether to bypass the handlers.
+* @param fallback - Opens the link the app's way.
+*/
+async function routeLink(openLink, url, options, fallback) {
+	if (!openLink || options.bypass) {
+		fallback();
+		return false;
+	}
+	const handled = await openLink({
+		url,
+		source: options.source,
+		...options.sessionId ? { sessionId: options.sessionId } : {}
+	}).catch(() => false);
+	if (!handled) fallback();
+	return handled;
+}
+/**
+* Opens `url` in a new browser tab (in the desktop app, main's window-open handler hands it to the
+* system): the app's way for a web link.
+*
+* @param url - The link.
+*/
+function openInNewTab(url) {
+	globalThis.open?.(url, "_blank", "noopener,noreferrer");
+}
+//#endregion
+export { openInNewTab, routeLink };