@formicoidea/labre-core 0.46.2 → 0.47.0

package/dist/_pkgs/affine-fragment-doc-title/translations.js

@@ -11,7 +11,65 @@ export const DOC_TITLE_PLACEHOLDER = [
     'com.labre.doc-title.placeholder',
     'Title',
 ];
+/* ── The title band (ADR 0035 §11), `./title-band/title-band.ts` ───────── */
+/** The band's accessible name: the group of property chips. */
+export const TITLE_BAND_LABEL = [
+    'com.labre.title-band.label',
+    'Page properties',
+];
+/** What an empty chip says after the property's name (REQ-PR-1). */
+export const TITLE_BAND_EMPTY = [
+    'com.labre.title-band.empty',
+    'Not set',
+];
+/** The "+" (REQ-PR-4); what it does is the host's. */
+export const TITLE_BAND_ADD = [
+    'com.labre.title-band.add',
+    'Add a property',
+];
+/** The button beside the "+" that opens the host's properties panel. */
+export const TITLE_BAND_OPEN_PANEL = [
+    'com.labre.title-band.open-panel',
+    'Open the properties panel',
+];
+/** Folds the chips away. */
+export const TITLE_BAND_COLLAPSE = [
+    'com.labre.title-band.collapse',
+    'Hide properties',
+];
+/** The folded band's only button; `count` is the number of chips. */
+export const TITLE_BAND_EXPAND = [
+    'com.labre.title-band.expand',
+    'Properties ({{count}})',
+];
+/** The accessible name of the skeleton drawn while the sheet loads. */
+export const TITLE_BAND_LOADING = [
+    'com.labre.title-band.loading',
+    'Loading properties',
+];
+/** Clears a select or a date from its editor. */
+export const TITLE_BAND_CLEAR = [
+    'com.labre.title-band.clear',
+    'Clear value',
+];
+/**
+ * The note header's row of child pages the document holds but does not
+ * display (ADR 0035 §9d, canvas view only).
+ */
+export const TITLE_BAND_NOT_SHOWN = [
+    'com.labre.title-band.not-shown',
+    'Not shown in this document',
+];
 /** Every wording this package declares, in the order it renders them. */
 export const DOC_TITLE_WORDINGS = [
     DOC_TITLE_PLACEHOLDER,
+    TITLE_BAND_ADD,
+    TITLE_BAND_CLEAR,
+    TITLE_BAND_COLLAPSE,
+    TITLE_BAND_EMPTY,
+    TITLE_BAND_EXPAND,
+    TITLE_BAND_LABEL,
+    TITLE_BAND_LOADING,
+    TITLE_BAND_NOT_SHOWN,
+    TITLE_BAND_OPEN_PANEL,
 ];

package/dist/_pkgs/affine-shared/services/index.d.ts

@@ -30,10 +30,12 @@ export * from './page-viewport-service.js';
 export * from './parse-url-service.js';
 export * from './pivot-materiality-publisher.js';
 export * from './pivot-properties-service.js';
+export * from './properties-panel-service.js';
 export * from './quick-search-service.js';
 export * from './selection-pane-service.js';
 export * from './telemetry-service/index.js';
 export * from './theme-service.js';
+export * from './title-band-service.js';
 export * from './toolbar-service/index.js';
 export * from './translation-service/index.js';
 export * from './universe-tag-defs-service.js';

package/dist/_pkgs/affine-shared/services/index.js

@@ -30,10 +30,12 @@ export * from './page-viewport-service.js';
 export * from './parse-url-service.js';
 export * from './pivot-materiality-publisher.js';
 export * from './pivot-properties-service.js';
+export * from './properties-panel-service.js';
 export * from './quick-search-service.js';
 export * from './selection-pane-service.js';
 export * from './telemetry-service/index.js';
 export * from './theme-service.js';
+export * from './title-band-service.js';
 export * from './toolbar-service/index.js';
 export * from './translation-service/index.js';
 export * from './universe-tag-defs-service.js';

package/dist/_pkgs/affine-shared/services/properties-panel-service.d.ts

@@ -0,0 +1,50 @@
+import type { ExtensionType } from '../../store/index.js';
+/**
+ * What the properties panel is asked to show (ADR 0035 §9b): one panel with a
+ * typed request, like the artefact catalogue's `open(owner)`.
+ *
+ * - `page`: the property sheet of one document — the button beside the title
+ *   band's "+" sends it, under the page title and in the note header alike.
+ * - `source`: the properties of one data source of a database, as a view
+ *   shows them. Declared now so the host's `open` is written once against the
+ *   whole union; the library sends it from the database view bar and the view
+ *   settings when they ship (ADR 0035, issue B10), never before.
+ *
+ * The union only widens: a new scope is a new member, and an existing member
+ * never gains a required field.
+ */
+export type PropertiesPanelRequest = {
+    scope: 'page';
+    docId: string;
+} | {
+    scope: 'source';
+    docId: string;
+    blockId: string;
+    sourceId: string;
+    viewId?: string;
+};
+/**
+ * The properties panel (ADR 0035 §9b), shaped as every panel seam of
+ * ADR 0034 §1: two verbs, nothing else. The host draws the panel where it
+ * wants it (the Labre app, in its left sidebar); the library never mounts one
+ * and keeps no "is it open" state, so a second `open` with another request
+ * retargets the host's panel rather than toggling anything here.
+ *
+ * Absent or `null`, the title band draws no panel button: a button that opens
+ * nothing is a lie. A database's properties stay reachable through the
+ * data-view's own properties popover.
+ */
+export interface PropertiesPanelService {
+    /** Show the panel for `request`. */
+    open(request: PropertiesPanelRequest): void;
+    /** Put it away. Writes nothing. */
+    close(): void;
+}
+export declare const PropertiesPanelProvider: import("../../global/di/types.js").ServiceIdentifier<PropertiesPanelService> & (<U extends PropertiesPanelService = PropertiesPanelService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: the host's properties panel, or `null` to say there is none.
+ *
+ * `di.override`, like `OutlinePanelExtension`, so a later registration always
+ * wins and registering twice never throws at boot.
+ */
+export declare function PropertiesPanelExtension(service: PropertiesPanelService | null): ExtensionType;

package/dist/_pkgs/affine-shared/services/properties-panel-service.js

@@ -0,0 +1,17 @@
+import { createIdentifier } from '../../global/di/index.js';
+export const PropertiesPanelProvider = createIdentifier('LabrePropertiesPanel');
+/**
+ * Host seam: the host's properties panel, or `null` to say there is none.
+ *
+ * `di.override`, like `OutlinePanelExtension`, so a later registration always
+ * wins and registering twice never throws at boot.
+ */
+export function PropertiesPanelExtension(service) {
+    return {
+        setup: di => {
+            // `null` rides through the factory on purpose: `getOptional` then
+            // reports the panel as absent, which is the whole "no button" story.
+            di.override(PropertiesPanelProvider, () => service);
+        },
+    };
+}

package/dist/_pkgs/affine-shared/services/title-band-service.d.ts

@@ -0,0 +1,124 @@
+import type { ExtensionType } from '../../store/index.js';
+import type { ReadonlySignal } from '@preact/signals-core';
+/**
+ * `TitleBandProvider` — the one seam that feeds the band of property chips
+ * under the page title and at the head of the page's note on the canvas
+ * (ADR 0035 §9d and §11, REQ-PR-1 and PR-7).
+ *
+ * **No value lives in the document.** A page's property values are the
+ * host's (the Labre app keeps them in SQL, labre ADR-0047); the library reads
+ * them here, draws them, and hands every edit back through `set`. It never
+ * learns where they live, never caches them and never applies a value itself:
+ * the host's store does, and owns the rollback.
+ *
+ * Not `PivotPropertiesProvider` (ADR 0006): that seam is keyed by an element's
+ * `pivotDocId`, read-only, with its own value union; this one is keyed by a
+ * document, written, and speaks the data-view property types, so a chip and a
+ * database cell read the same `type`, `data` and value.
+ *
+ * Absent, there is no band at all: no chips, no "+", no panel button, no "Not
+ * shown in this document" row, and nothing else changes.
+ */
+/**
+ * One visible property of a page's sheet, in the order the band draws it.
+ *
+ * `type` and `data` are a data-view property type and its config (`select`
+ * with `{ options }`, `number` with `{ format }`, …); `value` is the JSON a
+ * data-view cell of that type holds (`select`: an option id, `multi-select`:
+ * option ids, `date`: epoch milliseconds, `checkbox`: a boolean, text types: a
+ * string). `null` or `undefined` is an empty value, drawn as an empty chip
+ * that can still be clicked (REQ-PR-1).
+ *
+ * Visibility is resolved by the host: what is in the list is visible, in that
+ * order, including a visible property with no value.
+ */
+export interface TitleBandProperty {
+    /** Stable, host-defined id; what `set` receives back. */
+    id: string;
+    /** Whose definition this is: the workspace's, or the database's of a row. */
+    namespace: 'workspace' | 'database';
+    /** Display name, already localized by the host. */
+    name: string;
+    /** A data-view property type (`text`, `number`, `select`, …). */
+    type: string;
+    /** That type's config, as a data-view property holds it. */
+    data: Record<string, unknown>;
+    /** The JSON a data-view cell of that type holds; nullish is empty. */
+    value: unknown;
+    /** A read-only property draws its chip and opens no editor. */
+    readonly: boolean;
+}
+/**
+ * The state of one page's sheet. Same four states as ADR 0006: the signal may
+ * start at `loading` and settle later, and the library never awaits it.
+ */
+export type TitleBandSheetState = {
+    status: 'loading';
+} | {
+    status: 'ready';
+    properties: readonly TitleBandProperty[];
+}
+/** The page has no sheet this viewer may read. The band draws nothing. */
+ | {
+    status: 'missing';
+} | {
+    status: 'error';
+    reason?: string;
+};
+/**
+ * A child page this document holds but does not display (labre ADR-0045):
+ * the host decides what belongs here, the library never computes a parent or
+ * a child.
+ */
+export interface TitleBandNotShownPage {
+    docId: string;
+    /** The page's title; an empty one is drawn as "Untitled". */
+    title: string;
+}
+export interface TitleBandService {
+    /**
+     * The sheet of document `docId`. MUST return synchronously and MUST NOT
+     * throw; the same signal for the same document is the host's business (the
+     * band asks once per mounted document).
+     */
+    sheet$(docId: string): ReadonlySignal<TitleBandSheetState>;
+    /**
+     * Write one value. The band shows the chip as pending until the promise
+     * settles and never applies the value itself: the new value arrives through
+     * `sheet$`. A rejection is the host's to report and roll back; the band only
+     * clears its pending state. `value` is `null` to clear.
+     */
+    set(docId: string, propertyId: string, value: unknown): Promise<void>;
+    /**
+     * The band's "+" (REQ-PR-4): what it does is the host's (open the
+     * workspace's property settings, or create a database property directly
+     * on a row). Absent, there is no "+".
+     */
+    add?(docId: string): void;
+    /**
+     * Whether the band is collapsed for this document. The host decides where
+     * that is remembered (the Labre app: per device, REQ-PR-6). Absent, the
+     * band opens expanded every time and a collapse lasts while it is mounted.
+     */
+    collapsed$?(docId: string): ReadonlySignal<boolean>;
+    setCollapsed?(docId: string, collapsed: boolean): void;
+    /**
+     * The child pages this document holds but does not display. Read **in the
+     * canvas view only**, drawn in the note header as a "Not shown in this
+     * document" row of page links that open through the linked-document path
+     * (`RefNodeSlotsProvider.docLinkClicked`). In the page view the host draws
+     * that row under the title itself, so a document never shows two. Absent
+     * or empty, no row.
+     */
+    notShown$?(docId: string): ReadonlySignal<readonly TitleBandNotShownPage[]>;
+}
+export declare const TitleBandProvider: import("../../global/di/types.js").ServiceIdentifier<TitleBandService> & (<U extends TitleBandService = TitleBandService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: the service that feeds the title band. **No default is
+ * registered**: absence is a meaningful state (the playground without a mock,
+ * a host with no properties), and the band then draws nothing.
+ *
+ * `di.override`, so a later registration always wins and registering twice
+ * never throws at boot.
+ */
+export declare function TitleBandExtension(service: TitleBandService): ExtensionType;

package/dist/_pkgs/affine-shared/services/title-band-service.js

@@ -0,0 +1,17 @@
+import { createIdentifier } from '../../global/di/index.js';
+export const TitleBandProvider = createIdentifier('LabreTitleBand');
+/**
+ * Host seam: the service that feeds the title band. **No default is
+ * registered**: absence is a meaningful state (the playground without a mock,
+ * a host with no properties), and the band then draws nothing.
+ *
+ * `di.override`, so a later registration always wins and registering twice
+ * never throws at boot.
+ */
+export function TitleBandExtension(service) {
+    return {
+        setup: di => {
+            di.override(TitleBandProvider, () => service);
+        },
+    };
+}

package/dist/_pkgs/data-view/property-presets/converts.d.ts

@@ -18,14 +18,14 @@ export declare const presetPropertyConverts: ({
     from: any;
     to: any;
     convert: import("../index.js").ConvertFunction<import("../index.js").PropertyModel<"number", {
-        format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+        format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
         decimal?: number | undefined;
     }, number | null, number | null>, import("../index.js").PropertyModel<"progress", {}, number, number>>;
 } | {
     from: any;
     to: any;
     convert: import("../index.js").ConvertFunction<import("../index.js").PropertyModel<"progress", {}, number, number>, import("../index.js").PropertyModel<"number", {
-        format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+        format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
         decimal?: number | undefined;
     }, number | null, number | null>>;
 } | {

package/dist/_pkgs/data-view/property-presets/index.d.ts

@@ -13,7 +13,7 @@ export declare const propertyPresets: {
         }[];
     }, string[], string[]>;
     numberPropertyConfig: import("../index.js").PropertyMetaConfig<"number", {
-        format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+        format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
         decimal?: number | undefined;
     }, number | null, number | null>;
     progressPropertyConfig: import("../index.js").PropertyMetaConfig<"progress", {}, number, number>;

package/dist/_pkgs/data-view/property-presets/number/cell-renderer.d.ts

@@ -13,6 +13,6 @@ export declare class NumberCell extends BaseCellRenderer<number, number, NumberP
     render(): import("lit-html").TemplateResult<1>;
 }
 export declare const numberPropertyConfig: import("../../index.js").PropertyMetaConfig<"number", {
-    format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+    format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
     decimal?: number | undefined;
 }, number | null, number | null>;

package/dist/_pkgs/data-view/property-presets/number/define.d.ts

@@ -3,6 +3,6 @@ export declare const numberPropertyType: {
     modelConfig: <PropertyData extends Record<string, unknown> = Record<string, never>, RawValue = unknown, JsonValue = unknown>(ops: import("../../index.js").PropertyConfig<PropertyData, RawValue, JsonValue>) => import("../../index.js").PropertyModel<"number", PropertyData, RawValue, JsonValue>;
 };
 export declare const numberPropertyModelConfig: import("../../index.js").PropertyModel<"number", {
-    format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+    format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
     decimal?: number | undefined;
 }, number | null, number | null>;

package/dist/_pkgs/data-view/property-presets/number/types.d.ts

@@ -3,10 +3,10 @@ export declare const NumberPropertySchema: zod.ZodObject<{
     decimal: zod.ZodOptional<zod.ZodNumber>;
     format: zod.ZodEnum<["number", "numberWithCommas", "percent", "currencyYen", "currencyINR", "currencyCNY", "currencyUSD", "currencyEUR", "currencyGBP"]>;
 }, "strip", zod.ZodTypeAny, {
-    format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+    format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
     decimal?: number | undefined;
 }, {
-    format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+    format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
     decimal?: number | undefined;
 }>;
 export type NumberPropertyDataType = zod.infer<typeof NumberPropertySchema>;

package/dist/_pkgs/data-view/property-presets/pure-index.d.ts

@@ -10,7 +10,7 @@ export declare const propertyModelPresets: {
         }[];
     }, string[], string[]>;
     numberPropertyModelConfig: import("../index.js").PropertyModel<"number", {
-        format: "number" | "numberWithCommas" | "percent" | "currencyYen" | "currencyINR" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
+        format: "number" | "percent" | "numberWithCommas" | "currencyINR" | "currencyYen" | "currencyCNY" | "currencyUSD" | "currencyEUR" | "currencyGBP";
         decimal?: number | undefined;
     }, number | null, number | null>;
     progressPropertyModelConfig: import("../index.js").PropertyModel<"progress", {}, number, number>;
@@ -23,3 +23,4 @@ export declare const propertyModelPresets: {
     }, string | null, string | null>;
     textPropertyModelConfig: import("../index.js").PropertyModel<"text", {}, string, string>;
 };
+export { formatNumber, type NumberFormat, NumberFormatSchema, } from './number/utils/formatter.js';

package/dist/_pkgs/data-view/property-presets/pure-index.js

@@ -16,3 +16,7 @@ export const propertyModelPresets = {
     selectPropertyModelConfig,
     textPropertyModelConfig,
 };
+// The number preset's formats and formatter, so the title band's own copy of
+// the table (`fragments/doc-title/src/title-band/format.ts`) can be held to
+// it by a parity spec (`title-band-number-parity.unit.spec.ts`).
+export { formatNumber, NumberFormatSchema, } from './number/utils/formatter.js';

package/dist/_pkgs/std/extension/command-registry.d.ts

@@ -57,8 +57,16 @@ export type Availability = 'always' | 'selection' | 'selection:framework' | 'edi
  * command, so the behaviour, the availability rule and the single telemetry
  * emission stay in one place, and `CommandInvocation.surface` reports where the
  * user actually clicked instead of borrowing another surface's name.
+ *
+ * `'view-menu'` joined with the view actions (ADR 0034, amendment of
+ * 2026-10-13): what is proper to the view the editor shows — the canvas grid,
+ * its PNG and PDF export, the presentation — listed for a HOST menu (Labre's
+ * "This view" section of its header ⋯). The library draws no such menu; the
+ * host reads the projection `getViewActions` (`@labre/affine/host-panels`)
+ * and runs an entry through `runCommand`, so the behaviour and the one
+ * telemetry emission stay in the command.
  */
-export type CommandSurface = 'senior-menu' | 'catalogue' | 'palette' | 'contextual-toolbar' | 'agent';
+export type CommandSurface = 'senior-menu' | 'catalogue' | 'palette' | 'contextual-toolbar' | 'agent' | 'view-menu';
 export type CommandKind = 'artefact' | 'tool' | 'toggle' | 'legend' | 'action';
 /** Where the invocation came from — feeds `segment` / `module` / `control`. */
 export interface CommandInvocation {
@@ -130,6 +138,15 @@ export interface CommandDescriptor<P = void> {
      * only narrowing. Not projected into either manifest.
      */
     when?: (std: BlockStdScope) => boolean;
+    /**
+     * A toggle's current state, for a surface that draws a check mark (the
+     * host's view menu reads it through `getViewActions`). Absent = not a
+     * toggle. It may read signals: a caller that reads it inside an `effect`
+     * or a `computed` follows the state, whoever changes it. Not projected into
+     * either manifest — a state is a fact of the open editor, not of the
+     * catalogue.
+     */
+    checked?: (std: BlockStdScope) => boolean;
     /** THE new capability: invocable without a keyboard event. */
     run: (std: BlockStdScope, invocation: CommandInvocation, params?: P) => void | Promise<void>;
     /** Agent-facing parameter contract. */
@@ -472,6 +489,26 @@ export declare const isEditingOnCanvas: (std: BlockStdScope) => boolean;
  * in `when`. See ADR 0008 § Availability.
  */
 export declare function isCommandAvailable(std: BlockStdScope, command: AnyCommandDescriptor): boolean;
+/**
+ * A file a command hands back to its caller instead of downloading it — the
+ * PNG and PDF exports of the canvas. The library renders, the host decides
+ * where the bytes go (a download, a share sheet, an upload).
+ */
+export interface CommandFile {
+    blob: Blob;
+    /** Sanitised, extension included: `Order to cash.png`. */
+    filename: string;
+}
+/**
+ * The params of a command that produces a {@link CommandFile}. Given
+ * `deliver`, the command hands the file to it and downloads nothing; without
+ * it (the palette, a bound chord) the command downloads the file itself. Not
+ * declared as a zod `params`: a callback crosses no serializable seam, and an
+ * agent gets the download.
+ */
+export interface CommandFileParams {
+    deliver?: (file: CommandFile) => void;
+}
 /**
  * THE bottleneck: the one place a command runs, and therefore the one place
  * its telemetry is emitted and its usage measured. Every surface (sub-menu,
@@ -479,6 +516,18 @@ export declare function isCommandAvailable(std: BlockStdScope, command: AnyComma
  * the per-menu `track()` duplicates.
  */
 export declare function runCommand(std: BlockStdScope, command: AnyCommandDescriptor, invocation: CommandInvocation, params?: unknown): void;
+/**
+ * {@link runCommand} for a caller that waits: the same bottleneck (usage and
+ * telemetry recorded once, synchronously, as there), but the returned promise
+ * settles when the command's own work does and REJECTS when it fails, where
+ * `runCommand` only logs. For a gesture that shows progress — a menu entry
+ * that spins while the canvas export renders, then reports a failure.
+ *
+ * A separate function rather than a return value on `runCommand`: a promise
+ * returned there would read as a floating promise at every existing call site
+ * of every host.
+ */
+export declare function runCommandAsync(std: BlockStdScope, command: AnyCommandDescriptor, invocation: CommandInvocation, params?: unknown): Promise<void>;
 /**
  * One of the three permanent projections out of {@link CommandDescriptor} —
  * NOT a migration shim. It is TOTAL: keyless commands yield a descriptor with

package/dist/_pkgs/std/extension/command-registry.js

@@ -82,6 +82,17 @@ export function isCommandAvailable(std, command) {
             return !std.store.readonly;
     }
 }
+/** Shared by the two entry points below: run, then measure, then report. */
+function invokeCommand(std, command, invocation, params) {
+    const result = command.run(std, invocation, params);
+    // Before the telemetry gate on purpose: usage is measured for EVERY command,
+    // including the ones with no `telemetry` field and the self-emitting ones.
+    std.getOptional(CommandUsageIdentifier)?.record(command, invocation);
+    if (command.telemetry) {
+        std.getOptional(CommandTelemetryIdentifier)?.({ std, command, invocation });
+    }
+    return result;
+}
 /**
  * THE bottleneck: the one place a command runs, and therefore the one place
  * its telemetry is emitted and its usage measured. Every surface (sub-menu,
@@ -89,15 +100,23 @@ export function isCommandAvailable(std, command) {
  * the per-menu `track()` duplicates.
  */
 export function runCommand(std, command, invocation, params) {
-    const result = command.run(std, invocation, params);
+    const result = invokeCommand(std, command, invocation, params);
     if (result instanceof Promise)
         result.catch(console.error);
-    // Before the telemetry gate on purpose: usage is measured for EVERY command,
-    // including the ones with no `telemetry` field and the self-emitting ones.
-    std.getOptional(CommandUsageIdentifier)?.record(command, invocation);
-    if (!command.telemetry)
-        return;
-    std.getOptional(CommandTelemetryIdentifier)?.({ std, command, invocation });
+}
+/**
+ * {@link runCommand} for a caller that waits: the same bottleneck (usage and
+ * telemetry recorded once, synchronously, as there), but the returned promise
+ * settles when the command's own work does and REJECTS when it fails, where
+ * `runCommand` only logs. For a gesture that shows progress — a menu entry
+ * that spins while the canvas export renders, then reports a failure.
+ *
+ * A separate function rather than a return value on `runCommand`: a promise
+ * returned there would read as a floating promise at every existing call site
+ * of every host.
+ */
+export async function runCommandAsync(std, command, invocation, params) {
+    await invokeCommand(std, command, invocation, params);
 }
 /**
  * One of the three permanent projections out of {@link CommandDescriptor} —

package/dist/commands.js

@@ -1,6 +1,6 @@
 import { frameCommands } from './_pkgs/affine-block-frame/index.js';
 import { copyLinkCommands, coreCommands, pivotCommands, readingCommands, tagCommands, } from './_pkgs/affine-block-root/index.js';
-import { auditCommands, canvasGridCommands, exportSvgCommands, mapQualityCommands, selectionPaneCommands, userLayerCommands, } from './_pkgs/affine-block-surface/index.js';
+import { auditCommands, canvasExportCommands, canvasGridCommands, exportSvgCommands, mapQualityCommands, selectionPaneCommands, userLayerCommands, } from './_pkgs/affine-block-surface/index.js';
 import { edgeDirectionCommands } from './_pkgs/affine-gfx-connector/index.js';
 import { shapeCommands } from './_pkgs/affine-gfx-shape/index.js';
 import { toCommandManifestEntry, } from './_pkgs/std/index.js';
@@ -58,6 +58,7 @@ export function getCommands(flags) {
         ...selectionPaneCommands,
         ...frameCommands,
         ...canvasGridCommands,
+        ...canvasExportCommands,
         ...userLayerCommands,
         ...edgeDirectionCommands,
         ...(isCapabilityEnabled(flags, 'ai-audit') ? auditCommands : []),

package/dist/host-panels.d.ts

@@ -1,6 +1,6 @@
 import { type FramePreview } from './_pkgs/affine-fragment-frame-panel/index.js';
 import type { FrameBlockModel } from './_pkgs/affine-model/index.js';
-import type { BlockStdScope } from './_pkgs/std/index.js';
+import { type BlockStdScope, type CommandFile } from './_pkgs/std/index.js';
 /**
  * `@labre/affine/host-panels` — the verbs a host's own panel calls (ADR 0034
  * §4, docs/integrate/08-host-panels.md).
@@ -40,14 +40,23 @@ import type { BlockStdScope } from './_pkgs/std/index.js';
  * cannot find here is a gap in this module, not a reason to import a widget
  * package.
  *
+ * **The view actions** (amendment of 2026-10-13) are the same idea for a
+ * host's MENU rather than its panel: `getViewActions` projects the commands
+ * on the `'view-menu'` surface — the grid, the PNG and PDF export, Present —
+ * into rows of data (label, icon key, check, disabled), and `runViewAction`
+ * runs one and hands back the file an export produced. The host draws the
+ * rows (Labre's header ⋯, section "This view"); nothing here renders.
+ *
  * ponytail: `frameList` is a plain read, not a signal of the frame list; a
  * host follows reorders through `std.store.slots.blockUpdated` (08 says how).
  * A signal of the frame list is the upgrade path if two hosts ask.
  */
-export { type AnyCommandDescriptor, type CommandInvocation, type CommandOwner, type CommandSurface, getCommandIcon, getCommandsForSurface, getRegisteredCommands, runCommand, } from './_pkgs/std/index.js';
+export { type AnyCommandDescriptor, type CommandFile, type CommandInvocation, type CommandOwner, type CommandSurface, getCommandIcon, getCommandsForSurface, getRegisteredCommands, runCommand, runCommandAsync, } from './_pkgs/std/index.js';
 export { armArtefact } from './_pkgs/affine-widget-edgeless-toolbar/index.js';
 export { type SelectionPaneNode, selectionPaneTree, } from './_pkgs/affine-block-surface/index.js';
 export { frameCommands, type ReorderFramesParams, reorderFramesParams, } from './_pkgs/affine-block-frame/index.js';
+export { formatPropertyValue, isPropertyValueEmpty, } from './_pkgs/affine-fragment-doc-title/index.js';
+export type { PropertiesPanelRequest, PropertiesPanelService, TitleBandNotShownPage, TitleBandProperty, TitleBandService, TitleBandSheetState, } from './_pkgs/affine-shared/services/index.js';
 /**
  * The document's frames in presentation order, first slide first — the order
  * `canvas.frame.reorder` writes and the presentation walks. Works in page mode
@@ -88,3 +97,75 @@ export declare function createFramePreview(std: BlockStdScope, frame: FrameBlock
     height?: number;
     fillScreen?: boolean;
 }): FramePreview;
+/**
+ * One entry of the current view's own actions — what a host draws in the
+ * "This view" section of its menu (ADR 0034, amendment of 2026-10-13). Data
+ * only: the host owns the menu, the row, the spinner and the toast; the
+ * library owns what the entry does.
+ */
+export interface ViewAction {
+    /**
+     * The command id, stable across versions (`canvas.grid.toggle`): the key a
+     * host maps its own icon, test id or placement to, and what it passes back
+     * to {@link runViewAction}.
+     */
+    id: string;
+    /**
+     * The group the entry belongs to, from the command's `category`:
+     * `'display'` (the grid), `'export'` (PNG, PDF), `'present'`. A host draws
+     * a separator between groups, or places a group elsewhere (Labre keeps
+     * "Present" in its header). Open: a later minor may add a group.
+     */
+    section: string;
+    /** Resolved through the host's `TranslationExtension`, else English. */
+    label: string;
+    /** The `com.labre.*` key behind {@link label}, for a host that translates itself. */
+    labelKey: string;
+    /** Stable asset key; `getCommandIcon(std, iconKey)` is the library's icon. */
+    iconKey?: string;
+    /** Present only on a toggle: the state a check mark shows. */
+    checked?: boolean;
+    /**
+     * Listed but refused now (a write on a read-only document): draw it
+     * disabled. An entry that does not apply at all is not listed.
+     */
+    disabled: boolean;
+}
+/** What {@link runViewAction} hands back. */
+export interface ViewActionResult {
+    /**
+     * The file an export produced — the host downloads it, shares it, uploads
+     * it. Absent for an action that makes none, and for an export that found
+     * nothing to draw.
+     */
+    file?: CommandFile;
+}
+/**
+ * The actions proper to the view the editor shows now, in their declared
+ * order: the commands registered on the `'view-menu'` surface whose `scope`
+ * is this mode (or `'global'`) and whose `when` holds.
+ *
+ * `mode` is the view the host shows; omitted, it is read from
+ * `DocModeProvider`, and a provider that does not know (the library default
+ * answers `null`) leaves the choice to registration — the canvas commands are
+ * registered on the edgeless scope only. Flags apply by construction: a
+ * `frame: false` assembly registers no "Present", so it is not listed.
+ *
+ * Reactive when read inside an `effect` or a `computed`: `checked`, `when`
+ * and the read-only refusal read signals, so the list follows the grid, a
+ * toggle, a peer's save or a document turning read-only. Read it again after a
+ * mode switch: the `std` is rebuilt.
+ */
+export declare function getViewActions(std: BlockStdScope, mode?: 'page' | 'edgeless'): ViewAction[];
+/**
+ * Run one entry of {@link getViewActions} by its id, through `runCommand`'s
+ * bottleneck (usage and telemetry recorded once), and wait for it.
+ *
+ * Resolves when the action is done — after the export has rendered — with the
+ * file it produced, if any: the library renders, the host decides where the
+ * bytes go, and nothing is downloaded behind its back. Rejects when the action
+ * fails, so the host can say so. An id that is not a view action here, an
+ * entry that no longer applies or a refused one runs nothing and resolves
+ * with no file.
+ */
+export declare function runViewAction(std: BlockStdScope, id: string): Promise<ViewActionResult>;