@formicoidea/labre-core 0.43.1 → 0.46.0

package/dist/_pkgs/affine-shared/services/font-loader/config.d.ts

@@ -6,13 +6,13 @@ export declare const fontConfigSchema: z.ZodObject<{
     style: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     style: string;
-    font: string;
     url: string;
+    font: string;
     weight: string;
 }, {
     style: string;
-    font: string;
     url: string;
+    font: string;
     weight: string;
 }>;
 export type FontConfig = z.infer<typeof fontConfigSchema>;

package/dist/_pkgs/affine-shared/services/font-loader/font-loader-service.d.ts

@@ -36,18 +36,18 @@ export declare class FontLoaderService extends LifeCycleWatcher {
 }
 export declare const FontConfigIdentifier: import("../../../global/di/types.js").ServiceIdentifier<{
     style: string;
-    font: string;
     url: string;
+    font: string;
     weight: string;
 }[]> & (<U extends {
     style: string;
-    font: string;
     url: string;
+    font: string;
     weight: string;
 }[] = {
     style: string;
-    font: string;
     url: string;
+    font: string;
     weight: string;
 }[]>(variant: import("../../../global/di/types.js").ServiceVariant) => import("../../../global/di/types.js").ServiceIdentifier<U>);
 export declare const FontConfigExtension: (fontConfig: FontConfig[]) => ExtensionType;

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

@@ -2,6 +2,8 @@ export * from './artefact-catalogue-service.js';
 export * from './audit-service.js';
 export * from './auto-clear-selection-service.js';
 export * from './block-meta-service.js';
+export * from './canvas-grid.js';
+export * from './canvas-local-visibility.js';
 export * from './citation-service/index.js';
 export * from './command-usage-service.js';
 export * from './comment-service/index.js';
@@ -23,12 +25,13 @@ export * from './linked-doc-creation-service.js';
 export * from './native-clipboard-service.js';
 export * from './notification-service.js';
 export * from './open-doc-config.js';
+export * from './outline-panel-service.js';
 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 './quick-search-service.js';
-export * from './sidebar-service.js';
+export * from './selection-pane-service.js';
 export * from './telemetry-service/index.js';
 export * from './theme-service.js';
 export * from './toolbar-service/index.js';

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

@@ -2,6 +2,8 @@ export * from './artefact-catalogue-service.js';
 export * from './audit-service.js';
 export * from './auto-clear-selection-service.js';
 export * from './block-meta-service.js';
+export * from './canvas-grid.js';
+export * from './canvas-local-visibility.js';
 export * from './citation-service/index.js';
 export * from './command-usage-service.js';
 export * from './comment-service/index.js';
@@ -23,12 +25,13 @@ export * from './linked-doc-creation-service.js';
 export * from './native-clipboard-service.js';
 export * from './notification-service.js';
 export * from './open-doc-config.js';
+export * from './outline-panel-service.js';
 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 './quick-search-service.js';
-export * from './sidebar-service.js';
+export * from './selection-pane-service.js';
 export * from './telemetry-service/index.js';
 export * from './theme-service.js';
 export * from './toolbar-service/index.js';

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-storage.d.ts

@@ -8,29 +8,29 @@ declare const _StorageSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         description?: string | null | undefined;
         title?: string | null | undefined;
-        image?: string | null | undefined;
         icon?: string | null | undefined;
+        image?: string | null | undefined;
     }, {
         description?: string | null | undefined;
         title?: string | null | undefined;
-        image?: string | null | undefined;
         icon?: string | null | undefined;
+        image?: string | null | undefined;
     }>>;
     expires: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     data: Record<string, {
         description?: string | null | undefined;
         title?: string | null | undefined;
-        image?: string | null | undefined;
         icon?: string | null | undefined;
+        image?: string | null | undefined;
     }>;
     expires?: number | undefined;
 }, {
     data: Record<string, {
         description?: string | null | undefined;
         title?: string | null | undefined;
-        image?: string | null | undefined;
         icon?: string | null | undefined;
+        image?: string | null | undefined;
     }>;
     expires?: number | undefined;
 }>;

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

@@ -0,0 +1,31 @@
+import type { ExtensionType } from '../../store/index.js';
+/**
+ * The outline panel (ADR 0034 §1): the document's table of contents, drawn by
+ * the host beside the editor.
+ *
+ * The library never mounts an outline itself, so there is no default: a host
+ * that draws one registers this seam, a host that does not leaves it out. Its
+ * only caller in the library is the "View in TOC" link of the toast the note
+ * toolbar shows after a note's display mode changes
+ * (`blocks/note/src/configs/toolbar.ts`). Absent or `null`, that toast offers
+ * no link, because a link that opens nothing is a lie.
+ *
+ * It replaces the `open(tabId?)` seam inherited from AFFiNE (removed in 0.46,
+ * ADR 0034 §2): one caller, which opened a tab named by a string nobody typed
+ * anywhere else. Shaped exactly like `SelectionPaneService`, so every panel
+ * the library asks a host to show answers the same two verbs.
+ */
+export interface OutlinePanelService {
+    /** Show the outline. */
+    open(): void;
+    /** Put it away. Writes nothing. */
+    close(): void;
+}
+export declare const OutlinePanelProvider: import("../../global/di/types.js").ServiceIdentifier<OutlinePanelService> & (<U extends OutlinePanelService = OutlinePanelService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: the host's outline panel, or `null` to say there is none.
+ *
+ * `di.override`, like `SelectionPaneExtension`, so a later registration always
+ * wins and registering twice never throws at boot.
+ */
+export declare function OutlinePanelExtension(service: OutlinePanelService | null): ExtensionType;

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

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

package/dist/_pkgs/affine-shared/services/selection-pane-service.d.ts

@@ -0,0 +1,44 @@
+import type { ExtensionType } from '../../store/index.js';
+/**
+ * The selection pane (ADR 0031 §12): a list of the canvas elements by z-order,
+ * top first, with groups, lock, a filter by frame, and
+ * drag-to-reorder — PowerPoint's pane, on a Labre canvas.
+ *
+ * The seam is shaped exactly like `ArtefactCatalogueService`, and was
+ * challenged against it first: the catalogue's `open(owner)` is scoped to a
+ * framework, and stretching it to a second panel would have changed the
+ * signature of a shipped seam. So one more seam, two verbs, nothing else.
+ *
+ * Everything a pane draws is enumerable from the library without this seam:
+ * the rows from `selectionPaneTree(std)` (ids only, z-order, top first), the
+ * wordings from the element and the translation seam, and every action from
+ * the command registry (`canvas.element.reorder`, `canvas.element.lock`,
+ * `canvas.element.unlock`, `canvas.group.rename`), run through `runCommand`
+ * so the read-only check and the telemetry happen once whoever draws the
+ * pixels.
+ */
+export interface SelectionPaneService {
+    /** Show the pane. */
+    open(): void;
+    /** Put it away. Writes nothing. */
+    close(): void;
+}
+export declare const SelectionPaneProvider: import("../../global/di/types.js").ServiceIdentifier<SelectionPaneService> & (<U extends SelectionPaneService = SelectionPaneService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host override seam: replace the library's pane with the host's own — or
+ * switch it off entirely.
+ *
+ * **Replace** — a host with its own sidebar registers this extension; its
+ * implementation answers {@link SelectionPaneProvider}, the edgeless toolbar's
+ * button and the `canvas.selectionPane.toggle` command then call it, and the
+ * library's panel is never asked to open.
+ *
+ * **Disable** — pass `null`. The provider answers nothing: the toolbar button
+ * is not rendered and the toggle command is unavailable, because a control
+ * that opens nothing is a lie. A cold-assembly switch, decided when the editor
+ * is put together (ADR 0031 §13: no flag key for it).
+ *
+ * `di.override`, like `ArtefactCatalogueExtension`, so a host registering
+ * after the library's own default always wins.
+ */
+export declare function SelectionPaneExtension(service: SelectionPaneService | null): ExtensionType;

package/dist/_pkgs/affine-shared/services/selection-pane-service.js

@@ -0,0 +1,28 @@
+import { createIdentifier } from '../../global/di/index.js';
+export const SelectionPaneProvider = createIdentifier('AffineSelectionPane');
+/**
+ * Host override seam: replace the library's pane with the host's own — or
+ * switch it off entirely.
+ *
+ * **Replace** — a host with its own sidebar registers this extension; its
+ * implementation answers {@link SelectionPaneProvider}, the edgeless toolbar's
+ * button and the `canvas.selectionPane.toggle` command then call it, and the
+ * library's panel is never asked to open.
+ *
+ * **Disable** — pass `null`. The provider answers nothing: the toolbar button
+ * is not rendered and the toggle command is unavailable, because a control
+ * that opens nothing is a lie. A cold-assembly switch, decided when the editor
+ * is put together (ADR 0031 §13: no flag key for it).
+ *
+ * `di.override`, like `ArtefactCatalogueExtension`, so a host registering
+ * after the library's own default always wins.
+ */
+export function SelectionPaneExtension(service) {
+    return {
+        setup: di => {
+            // `null` rides through the factory on purpose: `getOptional` then
+            // reports the pane as absent, which is the whole disable story.
+            di.override(SelectionPaneProvider, () => service);
+        },
+    };
+}

package/dist/_pkgs/affine-shared/services/telemetry-service/lifecycle.d.ts

@@ -320,3 +320,72 @@ export interface DocumentDamagedEvent extends TelemetryEvent {
 export type DocumentHealthEvents = {
     DocumentDamaged: DocumentDamagedEvent;
 };
+/**
+ * The selection pane was opened (ADR 0031 §14).
+ *
+ * Worth measuring for the reason any optional surface is: a pane nobody opens
+ * is chrome the toolbar pays a slot for. `source` is how the user got there —
+ * the edgeless toolbar's button, the palette (or the agent, which invokes by
+ * name as the palette does), or a bound chord. Opening only: closing reports
+ * nothing, and neither does a toggle that closes the pane.
+ *
+ * No ids at all: the event is about the pane, never about what it lists.
+ */
+export interface SelectionPaneOpenedEvent extends TelemetryEvent {
+    page?: 'whiteboard editor';
+    source: 'toolbar' | 'palette' | 'shortcut';
+}
+/**
+ * Something on the canvas was hidden or shown (ADR 0031 §14).
+ *
+ * `scope: 'local'` is the viewer's own hide, which writes nothing to the
+ * document; `'everyone'` is "hide for everyone", which stores
+ * `hiddenForEveryone` on each element and syncs it.
+ * `target: 'layer'` is reserved for the layers stage. `count` is how many
+ * elements the ONE gesture actually changed — a gesture that changes nothing
+ * reports nothing.
+ *
+ * Counts only: never an element id, a type, a group title or any text.
+ */
+export interface CanvasVisibilityChangedEvent extends TelemetryEvent {
+    page?: 'whiteboard editor';
+    target: 'element' | 'layer';
+    scope: 'local' | 'everyone';
+    hidden: boolean;
+    count: number;
+}
+/**
+ * The canvas grid was turned on or off (ADR 0031 §14).
+ *
+ * `scope: 'local'` is the viewer's own toggle, which writes nothing to the
+ * document; `'everyone'` is "Save for everyone", which stores the grid on the
+ * document. `visible` is the state after the gesture. A save that changes
+ * nothing in the document reports nothing.
+ */
+export interface CanvasGridToggledEvent extends TelemetryEvent {
+    page?: 'whiteboard editor';
+    scope: 'local' | 'everyone';
+    visible: boolean;
+}
+/**
+ * The user layers changed (ADR 0031 §14).
+ *
+ * `layerCount` is how many layers the surface holds AFTER the gesture;
+ * `memberCount` is how many models the gesture moved (for `move-elements`)
+ * or deleted with the layer (for `delete`). A gesture that changes nothing
+ * reports nothing.
+ *
+ * Counts only: never a layer name, a layer id or any element text.
+ */
+export interface CanvasLayerChangedEvent extends TelemetryEvent {
+    page?: 'whiteboard editor';
+    action: 'create' | 'rename' | 'reorder' | 'delete' | 'move-elements';
+    layerCount: number;
+    memberCount?: number;
+}
+export type CanvasPaneEvents = {
+    SelectionPaneOpened: SelectionPaneOpenedEvent;
+    CanvasVisibilityChanged: CanvasVisibilityChangedEvent;
+    CanvasGridToggled: CanvasGridToggledEvent;
+    CanvasLayerChanged: CanvasLayerChangedEvent;
+};

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

@@ -2,12 +2,12 @@ import type { ExtensionType } from '../../../store/index.js';
 import type { CitationEvents } from './citation.js';
 import type { CodeBlockEvents } from './code-block.js';
 import type { OutDatabaseAllEvents } from './database.js';
-import type { AuditEvents, BlockLifecycleEvents, DocumentHealthEvents, FrameworkDiagramEvents, ValidationEvents } from './lifecycle.js';
+import type { AuditEvents, BlockLifecycleEvents, CanvasPaneEvents, DocumentHealthEvents, FrameworkDiagramEvents, ValidationEvents } from './lifecycle.js';
 import type { LinkToolbarEvents } from './link.js';
 import type { NoteEvents } from './note.js';
 import type { SlashMenuEvents } from './slash-menu.js';
 import type { AttachmentReloadedEvent, AttachmentReloadedEventInToolbar, AttachmentUpgradedEvent, AttachmentUploadedEvent, BlockCreationEvent, DocCreatedEvent, EdgelessToolPickedEvent, ElementCreationEvent, ElementLockEvent, ElementUpdatedEvent, LatexEvent, LinkedDocCreatedEvent, LinkEvent, MindMapCollapseEvent, TelemetryEvent } from './types.js';
-export type TelemetryEventMap = OutDatabaseAllEvents & LinkToolbarEvents & SlashMenuEvents & CodeBlockEvents & NoteEvents & CitationEvents & BlockLifecycleEvents & FrameworkDiagramEvents & ValidationEvents & AuditEvents & DocumentHealthEvents & {
+export type TelemetryEventMap = OutDatabaseAllEvents & LinkToolbarEvents & SlashMenuEvents & CodeBlockEvents & NoteEvents & CitationEvents & BlockLifecycleEvents & FrameworkDiagramEvents & ValidationEvents & AuditEvents & CanvasPaneEvents & DocumentHealthEvents & {
     DocCreated: DocCreatedEvent;
     Link: TelemetryEvent;
     LinkedDocCreated: LinkedDocCreatedEvent;

package/dist/_pkgs/affine-shared/services/translation-service/chrome.d.ts

@@ -188,6 +188,11 @@ export declare const STYLE_MENU_LABEL: ChromeWording;
 export declare const TEXT_FORMAT_BOLD: ChromeWording;
 export declare const TEXT_FORMAT_ITALIC: ChromeWording;
 export declare const TEXT_FORMAT_UNDERLINE: ChromeWording;
+/**
+ * Said by the canvas text toolbar's decoration toggles (`gfx/text`, beside
+ * {@link TEXT_FORMAT_UNDERLINE}) and by the inline format bar (ADR 0030).
+ */
+export declare const TEXT_FORMAT_OVERLINE: ChromeWording;
 export declare const TEXT_FORMAT_STRIKETHROUGH: ChromeWording;
 /**
  * The font weights and the one non-default font style a text toolbar offers —
@@ -459,6 +464,17 @@ export declare const FILL_COLOR_LABEL: ChromeWording;
  * `ROOT_TOOLBAR_CREATE_LINKED_DOC` (`blocks/root`).
  */
 export declare const TOOLBAR_CREATE_LINKED_DOC_TITLE: ChromeWording;
+/**
+ * "Turn into" — the block toolbar's conversions dropdown, said identically by
+ * the note's text row and the callout's own row (#468). Was
+ * `ROOT_TOOLBAR_TURN_INTO` (`blocks/root`); the key is kept.
+ */
+export declare const TOOLBAR_TURN_INTO: ChromeWording;
+/**
+ * …and that dropdown's accessible name. Was `ROOT_TOOLBAR_CONVERSIONS_ARIA`
+ * (`blocks/root`); the key is kept.
+ */
+export declare const TOOLBAR_CONVERSIONS_ARIA: ChromeWording;
 /**
  * "Edgeless content" — the surface-ref placeholder's own generic reference
  * kind, said identically by the drag-handle preview's fallback label. Was

package/dist/_pkgs/affine-shared/services/translation-service/chrome.js

@@ -335,6 +335,14 @@ export const TEXT_FORMAT_UNDERLINE = [
     'com.labre.text-format.underline',
     'Underline',
 ];
+/**
+ * Said by the canvas text toolbar's decoration toggles (`gfx/text`, beside
+ * {@link TEXT_FORMAT_UNDERLINE}) and by the inline format bar (ADR 0030).
+ */
+export const TEXT_FORMAT_OVERLINE = [
+    'com.labre.text-format.overline',
+    'Overline',
+];
 export const TEXT_FORMAT_STRIKETHROUGH = [
     'com.labre.text-format.strikethrough',
     'Strikethrough',
@@ -1026,6 +1034,23 @@ export const TOOLBAR_CREATE_LINKED_DOC_TITLE = [
     'com.labre.root.toolbar.create-linked-doc',
     'Create Linked Doc',
 ];
+/**
+ * "Turn into" — the block toolbar's conversions dropdown, said identically by
+ * the note's text row and the callout's own row (#468). Was
+ * `ROOT_TOOLBAR_TURN_INTO` (`blocks/root`); the key is kept.
+ */
+export const TOOLBAR_TURN_INTO = [
+    'com.labre.root.toolbar.turn-into',
+    'Turn into',
+];
+/**
+ * …and that dropdown's accessible name. Was `ROOT_TOOLBAR_CONVERSIONS_ARIA`
+ * (`blocks/root`); the key is kept.
+ */
+export const TOOLBAR_CONVERSIONS_ARIA = [
+    'com.labre.root.toolbar.conversions',
+    'Conversions',
+];
 /**
  * "Edgeless content" — the surface-ref placeholder's own generic reference
  * kind, said identically by the drag-handle preview's fallback label. Was
@@ -1203,6 +1228,7 @@ export const CHROME_WORDINGS = [
     TEXT_FORMAT_BOLD,
     TEXT_FORMAT_ITALIC,
     TEXT_FORMAT_UNDERLINE,
+    TEXT_FORMAT_OVERLINE,
     TEXT_FORMAT_STRIKETHROUGH,
     FONT_WEIGHT_LIGHT,
     FONT_WEIGHT_REGULAR,
@@ -1274,6 +1300,8 @@ export const CHROME_WORDINGS = [
     COLOR_LABEL,
     FILL_COLOR_LABEL,
     TOOLBAR_CREATE_LINKED_DOC_TITLE,
+    TOOLBAR_TURN_INTO,
+    TOOLBAR_CONVERSIONS_ARIA,
     EDGELESS_CONTENT_LABEL,
     TOOLBAR_EDIT,
     TOOLBAR_REMOVE_LINK,

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

@@ -1,5 +1,6 @@
 export { fontBaseStyle, fontSMStyle, fontXSStyle } from './font.js';
 export { reducedMotionStyle, SPRING_DURATION_MS, SPRING_EASING, springDuration, springEasing, } from './motion.js';
 export { panelBaseColorsStyle, panelBaseStyle } from './panel.js';
+export { PANEL_DRAG_THRESHOLD_PX, panelDragStarted, panelHeaderStyles, } from './panel-header.js';
 export { scrollbarStyle } from './scrollbar-style.js';
 export { affineTextStyles } from './text.js';

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

@@ -1,5 +1,6 @@
 export { fontBaseStyle, fontSMStyle, fontXSStyle } from './font.js';
 export { reducedMotionStyle, SPRING_DURATION_MS, SPRING_EASING, springDuration, springEasing, } from './motion.js';
 export { panelBaseColorsStyle, panelBaseStyle } from './panel.js';
+export { PANEL_DRAG_THRESHOLD_PX, panelDragStarted, panelHeaderStyles, } from './panel-header.js';
 export { scrollbarStyle } from './scrollbar-style.js';
 export { affineTextStyles } from './text.js';

package/dist/_pkgs/affine-shared/styles/panel-header.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The header of a side panel, as the frame panel draws it
+ * (`fragments/frame-panel`, `header/frame-panel-header.ts`): one 36px row,
+ * 8px side padding, no divider under it, a 14px / 500 secondary-text title
+ * and icon buttons whose glyph is secondary until hovered or active.
+ *
+ * Every side panel's header takes it from here — the frame panel, the
+ * selection pane and the artefact catalogue — so the three cannot drift
+ * apart (held by `panel-header-parity.unit.spec.ts` in `affine/all`). It lives
+ * this low because a widget may not import the frame panel: the frame panel
+ * depends on the frame block, which depends on the edgeless toolbar.
+ *
+ * A component opts in by adding the three classes to its own markup:
+ * `affine-panel-header` on the row, `affine-panel-header-title` on the title,
+ * `affine-panel-header-button` on each icon button.
+ */
+export declare const panelHeaderStyles: import("lit").CSSResult;
+/**
+ * Pointer travel, on either axis, before a press on a card or a row of a side
+ * panel becomes a drag rather than a click — the frame panel's threshold,
+ * shared with the selection pane so the two panels start a drag alike.
+ */
+export declare const PANEL_DRAG_THRESHOLD_PX = 5;
+/** Whether a press at `from` moved to `to` has travelled far enough to drag. */
+export declare function panelDragStarted(from: {
+    x: number;
+    y: number;
+}, to: {
+    x: number;
+    y: number;
+}): boolean;

package/dist/_pkgs/affine-shared/styles/panel-header.js

@@ -0,0 +1,61 @@
+import { css } from 'lit';
+import { fontSMStyle } from './font.js';
+/**
+ * The header of a side panel, as the frame panel draws it
+ * (`fragments/frame-panel`, `header/frame-panel-header.ts`): one 36px row,
+ * 8px side padding, no divider under it, a 14px / 500 secondary-text title
+ * and icon buttons whose glyph is secondary until hovered or active.
+ *
+ * Every side panel's header takes it from here — the frame panel, the
+ * selection pane and the artefact catalogue — so the three cannot drift
+ * apart (held by `panel-header-parity.unit.spec.ts` in `affine/all`). It lives
+ * this low because a widget may not import the frame panel: the frame panel
+ * depends on the frame block, which depends on the edgeless toolbar.
+ *
+ * A component opts in by adding the three classes to its own markup:
+ * `affine-panel-header` on the row, `affine-panel-header-title` on the title,
+ * `affine-panel-header-button` on each icon button.
+ */
+export const panelHeaderStyles = css `
+  .affine-panel-header {
+    display: flex;
+    flex: none;
+    width: 100%;
+    height: 36px;
+    align-items: center;
+    justify-content: space-between;
+    gap: 8px;
+    box-sizing: border-box;
+    padding: 0 8px;
+  }
+
+  ${fontSMStyle('.affine-panel-header-title')}
+
+  .affine-panel-header-title {
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    color: var(--affine-text-secondary-color);
+  }
+
+  .affine-panel-header-button svg {
+    color: var(--affine-icon-secondary);
+  }
+
+  .affine-panel-header-button:hover svg,
+  .affine-panel-header-button.active svg {
+    color: var(--affine-icon-color);
+  }
+`;
+/**
+ * Pointer travel, on either axis, before a press on a card or a row of a side
+ * panel becomes a drag rather than a click — the frame panel's threshold,
+ * shared with the selection pane so the two panels start a drag alike.
+ */
+export const PANEL_DRAG_THRESHOLD_PX = 5;
+/** Whether a press at `from` moved to `to` has travelled far enough to drag. */
+export function panelDragStarted(from, to) {
+    return (Math.abs(from.x - to.x) >= PANEL_DRAG_THRESHOLD_PX ||
+        Math.abs(from.y - to.y) >= PANEL_DRAG_THRESHOLD_PX);
+}

package/dist/_pkgs/affine-shared/styles/text.js

@@ -1,11 +1,11 @@
 export function affineTextStyles(props, override) {
-    let textDecorations = '';
-    if (props.underline) {
-        textDecorations += 'underline';
-    }
-    if (props.strike) {
-        textDecorations += ' line-through';
-    }
+    const textDecorations = [
+        props.underline && 'underline',
+        props.overline && 'overline',
+        props.strike && 'line-through',
+    ]
+        .filter(Boolean)
+        .join(' ');
     let inlineCodeStyle = {};
     if (props.code) {
         inlineCodeStyle = {

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

@@ -24,6 +24,12 @@ export type AffineTextStyleAttributes = {
     bold?: true | null;
     italic?: true | null;
     underline?: true | null;
+    /**
+     * Declared at the affine level only, like `color`: the store's base
+     * attributes do not know it (ADR 0030 §5), and the editor schema is the
+     * intersection of those and every inline spec.
+     */
+    overline?: true | null;
     strike?: true | null;
     code?: true | null;
     color?: string | null;

package/dist/_pkgs/affine-shared/utils/canvas-export-colors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Turns one colour the browser understands into `rgb()` / `rgba()`.
+ */
+export type ResolveLegacyColor = (color: string) => string;
+/**
+ * `value` with every modern colour function in it replaced by what `resolve`
+ * makes of it — the whole of `oklch(0.7 0.1 200)`, or each colour of a
+ * `box-shadow` list. A value with none comes back as the same string. Also
+ * what the `backgroundColor` option of html2canvas goes through.
+ */
+export declare function toLegacyColors(value: string, resolve?: ResolveLegacyColor): string;
+/**
+ * Rewrites, inline on the html2canvas CLONE, every computed colour html2canvas
+ * would choke on, so a host theme in `oklch()` (or the library's own
+ * `color-mix()`) cannot abort a PNG/PDF export or a "copy as image". Call it
+ * first in every `onclone`.
+ *
+ * html2canvas parses the computed style of the captured subtree AND of the
+ * clone's `<html>` and `<body>` (their background), so those two are covered
+ * too; shadow roots are already flattened into the clone by then. The resolved
+ * value is written over whatever produced it — a CSS variable, a stylesheet
+ * rule — as an `!important` inline declaration, which is what the computed
+ * style then reports. Every value is read before any is written, so the
+ * cascade is recomputed once rather than once per node.
+ */
+export declare function normalizeCanvasExportColors(documentClone: Document, subtree: Element, resolve?: ResolveLegacyColor): void;