@formicoidea/labre-core 0.58.0 → 0.60.0

package/dist/_pkgs/affine-model/elements/bpmn/pool.js

@@ -33,7 +33,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     return useValue ? value : void 0;
 };
 import { rotatePoint } from '../../../global/gfx/index.js';
-import { field } from '../../../std/gfx/index.js';
+import { field, local } from '../../../std/gfx/index.js';
 import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
 import { POOL_BAND_WIDTH, POOL_LANE_BAND_WIDTH } from './consts.js';
 /**
@@ -68,6 +68,9 @@ let BpmnPoolElementModel = (() => {
     let _lanes_decorators;
     let _lanes_initializers = [];
     let _lanes_extraInitializers = [];
+    let _paintedBands_decorators;
+    let _paintedBands_initializers = [];
+    let _paintedBands_extraInitializers = [];
     return class BpmnPoolElementModel extends _classSuper {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
@@ -76,11 +79,13 @@ let BpmnPoolElementModel = (() => {
             _rotate_decorators = [field(0)];
             _xywh_decorators = [field('[0,0,0,0]')];
             _lanes_decorators = [field()];
+            _paintedBands_decorators = [local()];
             __esDecorate(this, null, _name_decorators, { kind: "accessor", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
             __esDecorate(this, null, _resizeEnabled_decorators, { kind: "accessor", name: "resizeEnabled", static: false, private: false, access: { has: obj => "resizeEnabled" in obj, get: obj => obj.resizeEnabled, set: (obj, value) => { obj.resizeEnabled = value; } }, metadata: _metadata }, _resizeEnabled_initializers, _resizeEnabled_extraInitializers);
             __esDecorate(this, null, _rotate_decorators, { kind: "accessor", name: "rotate", static: false, private: false, access: { has: obj => "rotate" in obj, get: obj => obj.rotate, set: (obj, value) => { obj.rotate = value; } }, metadata: _metadata }, _rotate_initializers, _rotate_extraInitializers);
             __esDecorate(this, null, _xywh_decorators, { kind: "accessor", name: "xywh", static: false, private: false, access: { has: obj => "xywh" in obj, get: obj => obj.xywh, set: (obj, value) => { obj.xywh = value; } }, metadata: _metadata }, _xywh_initializers, _xywh_extraInitializers);
             __esDecorate(this, null, _lanes_decorators, { kind: "accessor", name: "lanes", static: false, private: false, access: { has: obj => "lanes" in obj, get: obj => obj.lanes, set: (obj, value) => { obj.lanes = value; } }, metadata: _metadata }, _lanes_initializers, _lanes_extraInitializers);
+            __esDecorate(this, null, _paintedBands_decorators, { kind: "accessor", name: "paintedBands", static: false, private: false, access: { has: obj => "paintedBands" in obj, get: obj => obj.paintedBands, set: (obj, value) => { obj.paintedBands = value; } }, metadata: _metadata }, _paintedBands_initializers, _paintedBands_extraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
         get type() {
@@ -133,6 +138,25 @@ let BpmnPoolElementModel = (() => {
          */
         get lanes() { return this.#lanes_accessor_storage; }
         set lanes(value) { this.#lanes_accessor_storage = value; }
+        #paintedBands_accessor_storage = (__runInitializers(this, _lanes_extraInitializers), __runInitializers(this, _paintedBands_initializers, undefined));
+        /**
+         * The title band widths the renderer last PAINTED this pool with: the
+         * participant band (`margin`) and the shared lane strip (`zoneBandWidth`).
+         *
+         * The bands grow with their names (`fit: 'wrap'`, PO 2026-10-27), which is a
+         * function of measured text, and this package cannot measure text. So the
+         * BPMN renderer, which does, caches what it painted here after each paint,
+         * and {@link includesPoint} selects by it: a click on a band widened by a
+         * two-line name picks the pool, as the painted band promises.
+         *
+         * A derived, view-time fact cached on the model, NEVER stored — the reasoning
+         * ADR 0031 applies to the local hide: `@local()` lives in `_local` and is not
+         * written to the Y.Map, so no document carries it, no peer receives it and no
+         * snapshot serialises it. Undefined until the first paint; a pool never
+         * painted (headless) selects by the declared widths.
+         */
+        get paintedBands() { return this.#paintedBands_accessor_storage; }
+        set paintedBands(value) { this.#paintedBands_accessor_storage = value; }
         /**
          * A pool is picked by its BORDER — and by its TITLE BANDS, which is the one
          * carve-out the recette kept (issue #194).
@@ -174,11 +198,16 @@ let BpmnPoolElementModel = (() => {
             }
             if (ly < 0 || ly > h || lx < 0)
                 return false;
+            // As wide as last painted (`paintedBands`), the declared widths until then.
             // Clamped to a pool narrower than its own margin — the degenerate case the
             // renderer clamps too.
-            const band = Math.min(POOL_BAND_WIDTH, w);
+            const painted = this.paintedBands ?? {
+                margin: POOL_BAND_WIDTH,
+                zoneBandWidth: POOL_LANE_BAND_WIDTH,
+            };
+            const band = Math.min(painted.margin, w);
             const lanes = this.hasUsableLane
-                ? Math.min(POOL_LANE_BAND_WIDTH, w - band)
+                ? Math.min(painted.zoneBandWidth, w - band)
                 : 0;
             return lx <= band + Math.max(lanes, 0);
         }
@@ -202,7 +231,7 @@ let BpmnPoolElementModel = (() => {
         }
         constructor() {
             super(...arguments);
-            __runInitializers(this, _lanes_extraInitializers);
+            __runInitializers(this, _paintedBands_extraInitializers);
         }
     };
 })();

package/dist/_pkgs/affine-model/elements/c4/board.d.ts

@@ -2,28 +2,6 @@ import type { SerializedXYWH } from '../../../global/gfx/index.js';
 import type { PointTestOptions } from '../../../std/gfx/index.js';
 import type { FrameworkBackgroundProps } from '../framework-background/index.js';
 import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
-/**
- * Height of the board's title band — the header strip across the top of the
- * sheet the diagram title is written in, in model units.
- *
- * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
- * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
- * board's own hit test needs it (a board is clickable by its title band as well
- * as its border), and `affine-model` cannot reach into `affine-block-surface`
- * where the declaration is resolved. One number, owned by the layer that both
- * the declaration and the hit test can read.
- *
- * It is the board's TOP MARGIN, and it always was — the deep inset the plot
- * gives up so the title has somewhere to be written. Naming it says out loud
- * what was already true, so the strip that is painted, the strip that is picked
- * and the strip that opens the rename are one number rather than three.
- *
- * 56 is what the title has been written in since the pack shipped: a 20-unit
- * title, sitting on a baseline a third of the band up from its foot, with the
- * rest as breathing room above and below. Changing it moves the title, so it is
- * a visual decision and not a hit-test one.
- */
-export declare const C4_BOARD_TITLE_BAND_HEIGHT = 56;
 /**
  * Which of C4's levels this board draws — the DECLARED fact, as opposed to the
  * title, which is free text and says whatever its author wants it to.

package/dist/_pkgs/affine-model/elements/c4/board.js

@@ -35,28 +35,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 import { rotatePoint } from '../../../global/gfx/index.js';
 import { field } from '../../../std/gfx/index.js';
 import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
-/**
- * Height of the board's title band — the header strip across the top of the
- * sheet the diagram title is written in, in model units.
- *
- * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
- * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
- * board's own hit test needs it (a board is clickable by its title band as well
- * as its border), and `affine-model` cannot reach into `affine-block-surface`
- * where the declaration is resolved. One number, owned by the layer that both
- * the declaration and the hit test can read.
- *
- * It is the board's TOP MARGIN, and it always was — the deep inset the plot
- * gives up so the title has somewhere to be written. Naming it says out loud
- * what was already true, so the strip that is painted, the strip that is picked
- * and the strip that opens the rename are one number rather than three.
- *
- * 56 is what the title has been written in since the pack shipped: a 20-unit
- * title, sitting on a baseline a third of the band up from its foot, with the
- * rest as breathing room above and below. Changing it moves the title, so it is
- * a visual decision and not a hit-test one.
- */
-export const C4_BOARD_TITLE_BAND_HEIGHT = 56;
+import { C4_BOARD_TITLE_BAND_HEIGHT } from './consts.js';
 /**
  * The C4 board: the sheet one diagram of the model is drawn on — a context
  * diagram, a container diagram, a component diagram. A framework background like

package/dist/_pkgs/affine-model/elements/c4/consts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Constants moved out of the element-class files of this folder, unchanged, so
+ * the model's headless entry (`@labre/affine-model/headless`) exports them
+ * without `@labre/std/gfx` behind them (ADR 0012, P3 as amended 2026-10-14;
+ * the C4 toolbox of `docs/adr/0045` reads the board's metrics from there).
+ * The folder index re-exports this file.
+ */
+/**
+ * Height of the board's title band — the header strip across the top of the
+ * sheet the diagram title is written in, in model units.
+ *
+ * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
+ * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
+ * board's own hit test needs it (a board is clickable by its title band as well
+ * as its border), and `affine-model` cannot reach into `affine-block-surface`
+ * where the declaration is resolved. One number, owned by the layer that both
+ * the declaration and the hit test can read.
+ *
+ * It is the board's TOP MARGIN, and it always was — the deep inset the plot
+ * gives up so the title has somewhere to be written. Naming it says out loud
+ * what was already true, so the strip that is painted, the strip that is picked
+ * and the strip that opens the rename are one number rather than three.
+ *
+ * 56 is what the title has been written in since the pack shipped: a 20-unit
+ * title, sitting on a baseline a third of the band up from its foot, with the
+ * rest as breathing room above and below. Changing it moves the title, so it is
+ * a visual decision and not a hit-test one.
+ */
+export declare const C4_BOARD_TITLE_BAND_HEIGHT = 56;

package/dist/_pkgs/affine-model/elements/c4/consts.js

@@ -0,0 +1,29 @@
+/**
+ * Constants moved out of the element-class files of this folder, unchanged, so
+ * the model's headless entry (`@labre/affine-model/headless`) exports them
+ * without `@labre/std/gfx` behind them (ADR 0012, P3 as amended 2026-10-14;
+ * the C4 toolbox of `docs/adr/0045` reads the board's metrics from there).
+ * The folder index re-exports this file.
+ */
+/**
+ * Height of the board's title band — the header strip across the top of the
+ * sheet the diagram title is written in, in model units.
+ *
+ * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
+ * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
+ * board's own hit test needs it (a board is clickable by its title band as well
+ * as its border), and `affine-model` cannot reach into `affine-block-surface`
+ * where the declaration is resolved. One number, owned by the layer that both
+ * the declaration and the hit test can read.
+ *
+ * It is the board's TOP MARGIN, and it always was — the deep inset the plot
+ * gives up so the title has somewhere to be written. Naming it says out loud
+ * what was already true, so the strip that is painted, the strip that is picked
+ * and the strip that opens the rename are one number rather than three.
+ *
+ * 56 is what the title has been written in since the pack shipped: a 20-unit
+ * title, sitting on a baseline a third of the band up from its foot, with the
+ * rest as breathing room above and below. Changing it moves the title, so it is
+ * a visual decision and not a hit-test one.
+ */
+export const C4_BOARD_TITLE_BAND_HEIGHT = 56;

package/dist/_pkgs/affine-model/elements/c4/index.d.ts

@@ -1,3 +1,4 @@
 export * from './board.js';
 export * from './boundary.js';
+export * from './consts.js';
 export * from './node.js';

package/dist/_pkgs/affine-model/elements/c4/index.js

@@ -1,3 +1,4 @@
 export * from './board.js';
 export * from './boundary.js';
+export * from './consts.js';
 export * from './node.js';

package/dist/_pkgs/affine-model/headless.d.ts

@@ -13,6 +13,7 @@
  */
 export * from './consts/index.js';
 export * from './elements/bpmn/consts.js';
+export * from './elements/c4/consts.js';
 export * from './elements/connector/end-label.js';
 export { DEFAULT_POLYGON_VERTICES } from './elements/shape/api/polygon.js';
 export * from './elements/uml/consts.js';

package/dist/_pkgs/affine-model/headless.js

@@ -13,6 +13,7 @@
  */
 export * from './consts/index.js';
 export * from './elements/bpmn/consts.js';
+export * from './elements/c4/consts.js';
 export * from './elements/connector/end-label.js';
 export { DEFAULT_POLYGON_VERTICES } from './elements/shape/api/polygon.js';
 export * from './elements/uml/consts.js';

package/dist/_pkgs/affine-shared/services/edit-props-store.d.ts

@@ -47,26 +47,12 @@ declare const LocalPropsSchema: z.ZodObject<{
     presentNoFrameToastShown: z.ZodBoolean;
     autoHideEmbedHTMLFullScreenToolbar: z.ZodBoolean;
     connectorCenterAnchor: z.ZodDefault<z.ZodBoolean>;
-    /**
-     * The ids this viewer hid on this document's canvas (ADR 0031 §8). Per
-     * viewer and per document, like the viewport; never written to the
-     * document. Owned by `CanvasLocalVisibility`.
-     */
     localHiddenElements: z.ZodArray<z.ZodString, "many">;
-    /**
-     * The user layers this viewer hid on this document's canvas (ADR 0031 §8,
-     * stage 7). Same owner, same key scheme, same lifetime as
-     * `localHiddenElements`; a separate key so the element list keeps the shape
-     * it already has in viewers' storage.
-     */
     localHiddenLayers: z.ZodArray<z.ZodString, "many">;
-    /**
-     * This viewer's grid override on this document's canvas (ADR 0031 §11),
-     * keyed like the viewport. Absent = the document, the host or the library
-     * decides. Owned by `CanvasGrid`.
-     */
     localShowGrid: z.ZodBoolean;
+    showInvisibles: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
+    showInvisibles: boolean;
     viewport: {
         zoom: number;
         centerX: number;
@@ -85,6 +71,7 @@ declare const LocalPropsSchema: z.ZodObject<{
     localHiddenLayers: string[];
     localShowGrid: boolean;
 }, {
+    showInvisibles: boolean;
     viewport: {
         zoom: number;
         centerX: number;

package/dist/_pkgs/affine-shared/services/edit-props-store.js

@@ -37,25 +37,23 @@ const LocalPropsSchema = z.object({
     presentNoFrameToastShown: z.boolean(),
     autoHideEmbedHTMLFullScreenToolbar: z.boolean(),
     connectorCenterAnchor: z.boolean().default(false),
-    /**
-     * The ids this viewer hid on this document's canvas (ADR 0031 §8). Per
-     * viewer and per document, like the viewport; never written to the
-     * document. Owned by `CanvasLocalVisibility`.
-     */
+    // The ids this viewer hid on this document's canvas (ADR 0031 §8). Per
+    // viewer and per document, like the viewport; never written to the
+    // document. Owned by `CanvasLocalVisibility`.
     localHiddenElements: z.array(z.string()),
-    /**
-     * The user layers this viewer hid on this document's canvas (ADR 0031 §8,
-     * stage 7). Same owner, same key scheme, same lifetime as
-     * `localHiddenElements`; a separate key so the element list keeps the shape
-     * it already has in viewers' storage.
-     */
+    // The user layers this viewer hid on this document's canvas (ADR 0031 §8,
+    // stage 7). Same owner, same key scheme, same lifetime as
+    // `localHiddenElements`; a separate key so the element list keeps the shape
+    // it already has in viewers' storage.
     localHiddenLayers: z.array(z.string()),
-    /**
-     * This viewer's grid override on this document's canvas (ADR 0031 §11),
-     * keyed like the viewport. Absent = the document, the host or the library
-     * decides. Owned by `CanvasGrid`.
-     */
+    // This viewer's grid override on this document's canvas (ADR 0031 §11),
+    // keyed like the viewport. Absent = the document, the host or the library
+    // decides. Owned by `CanvasGrid`.
     localShowGrid: z.boolean(),
+    // This viewer's "show special characters" choice, for every document:
+    // a writer's habit, like a word processor's ¶ button. Absent = the host's
+    // default, else off. Owned by `InvisibleCharacters`.
+    showInvisibles: z.boolean(),
 });
 function isLocalProp(key) {
     return key in LocalPropsSchema.shape;
@@ -137,6 +135,8 @@ export class EditPropsStore extends LifeCycleWatcher {
                 return 'blocksuite:' + id + ':localHiddenLayers';
             case 'localShowGrid':
                 return 'blocksuite:' + id + ':localShowGrid';
+            case 'showInvisibles':
+                return 'blocksuite:showInvisibles';
             default:
                 return key;
         }

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

@@ -6,6 +6,7 @@ export declare const GeneralSettingSchema: z.ZodObject<{
     edgelessScrollZoom: z.ZodDefault<z.ZodBoolean>;
     edgelessDisableScheduleUpdate: z.ZodDefault<z.ZodBoolean>;
     edgelessShowGrid: z.ZodOptional<z.ZodBoolean>;
+    showInvisibles: z.ZodOptional<z.ZodBoolean>;
     docCanvasPreferView: z.ZodDefault<z.ZodEnum<["affine:embed-linked-doc", "affine:embed-synced-doc"]>>;
 } & {
     connector: z.ZodDefault<z.ZodObject<{
@@ -1481,6 +1482,7 @@ export declare const GeneralSettingSchema: z.ZodObject<{
         textVerticalAlign?: import("../../affine-model/index.js").TextVerticalAlign | undefined;
     };
     edgelessShowGrid?: boolean | undefined;
+    showInvisibles?: boolean | undefined;
 }, {
     text?: {
         color: string | {
@@ -1515,6 +1517,7 @@ export declare const GeneralSettingSchema: z.ZodObject<{
     edgelessScrollZoom?: boolean | undefined;
     edgelessDisableScheduleUpdate?: boolean | undefined;
     edgelessShowGrid?: boolean | undefined;
+    showInvisibles?: boolean | undefined;
     docCanvasPreferView?: "affine:embed-linked-doc" | "affine:embed-synced-doc" | undefined;
     connector?: {
         mode: import("../../affine-model/index.js").ConnectorMode;

package/dist/_pkgs/affine-shared/services/editor-setting-service.js

@@ -12,6 +12,10 @@ export const GeneralSettingSchema = z
     // A line comment, not JSDoc: see the guard in
     // `affine/all/src/__tests__/zod-schema-jsdoc.unit.spec.ts`.
     edgelessShowGrid: z.boolean().optional(),
+    // The host's (or the user's) default for "show special characters"
+    // (`text.invisibles.toggle`). Absent means off. A viewer's own toggle
+    // wins over it. A line comment, not JSDoc (same guard as above).
+    showInvisibles: z.boolean().optional(),
     docCanvasPreferView: z
         .enum(['affine:embed-linked-doc', 'affine:embed-synced-doc'])
         .default('affine:embed-synced-doc'),

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

@@ -14,6 +14,7 @@ export * from './doc-mode-service.js';
 export * from './drag-handle-config.js';
 export * from './edit-props-store.js';
 export * from './editor-setting-service.js';
+export * from './invisible-characters.js';
 export * from './embed-iframe/index.js';
 export * from './embed-option-service.js';
 export * from './feature-flag-service.js';

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

@@ -14,6 +14,7 @@ export * from './doc-mode-service.js';
 export * from './drag-handle-config.js';
 export * from './edit-props-store.js';
 export * from './editor-setting-service.js';
+export * from './invisible-characters.js';
 export * from './embed-iframe/index.js';
 export * from './embed-option-service.js';
 export * from './feature-flag-service.js';

package/dist/_pkgs/affine-shared/services/invisible-characters.d.ts

@@ -0,0 +1,33 @@
+import type { Container } from '../../global/di/index.js';
+import { LifeCycleWatcher } from '../../std/index.js';
+import { type ReadonlySignal } from '@preact/signals-core';
+/**
+ * "Show special characters" as THIS viewer sees it (`text.invisibles.toggle`),
+ * modelled on `CanvasGrid` minus the document level: a display preference
+ * writes nothing to the document, so a reader may toggle it too.
+ *
+ * Nearest decision first: the viewer's own toggle (an `EditPropsStore`
+ * `localStorage` prop, the same for every document, a writer's habit), the
+ * host's default (`EditorSettingProvider`'s `showInvisibles`), off.
+ *
+ * Read by every `v-text` under the editor host through
+ * `InvisibleCharactersDisplayIdentifier` (`@labre/std/inline`), which marks
+ * spaces, tabs, no-break spaces and invisible characters; the line ends are
+ * drawn from {@link SHOW_INVISIBLES_ATTR}, which this service keeps on the
+ * host while `visible$` holds. The document title sits outside the host and
+ * shows no marks.
+ */
+export declare class InvisibleCharacters extends LifeCycleWatcher {
+    static key: string;
+    static setup(di: Container): void;
+    private readonly _local$;
+    /** Whether this viewer sees the special characters. */
+    readonly visible$: ReadonlySignal<boolean>;
+    /** What `v-text` reads. */
+    readonly showInvisibles$: ReadonlySignal<boolean>;
+    private _stopHostAttribute;
+    /** Flip the display for this viewer. Answers the new state. */
+    toggle(): boolean;
+    mounted(): void;
+    unmounted(): void;
+}

package/dist/_pkgs/affine-shared/services/invisible-characters.js

@@ -0,0 +1,63 @@
+import { LifeCycleWatcher } from '../../std/index.js';
+import { InvisibleCharactersDisplayIdentifier, SHOW_INVISIBLES_ATTR, } from '../../std/inline/index.js';
+import { computed, effect, signal, } from '@preact/signals-core';
+import { EditPropsStore } from './edit-props-store.js';
+import { EditorSettingProvider } from './editor-setting-service.js';
+/**
+ * "Show special characters" as THIS viewer sees it (`text.invisibles.toggle`),
+ * modelled on `CanvasGrid` minus the document level: a display preference
+ * writes nothing to the document, so a reader may toggle it too.
+ *
+ * Nearest decision first: the viewer's own toggle (an `EditPropsStore`
+ * `localStorage` prop, the same for every document, a writer's habit), the
+ * host's default (`EditorSettingProvider`'s `showInvisibles`), off.
+ *
+ * Read by every `v-text` under the editor host through
+ * `InvisibleCharactersDisplayIdentifier` (`@labre/std/inline`), which marks
+ * spaces, tabs, no-break spaces and invisible characters; the line ends are
+ * drawn from {@link SHOW_INVISIBLES_ATTR}, which this service keeps on the
+ * host while `visible$` holds. The document title sits outside the host and
+ * shows no marks.
+ */
+export class InvisibleCharacters extends LifeCycleWatcher {
+    constructor() {
+        super(...arguments);
+        this._local$ = signal(undefined);
+        /** Whether this viewer sees the special characters. */
+        this.visible$ = computed(() => this._local$.value ??
+            this.std.getOptional(EditorSettingProvider)?.setting$.value
+                .showInvisibles ??
+            false);
+        /** What `v-text` reads. */
+        this.showInvisibles$ = this.visible$;
+        this._stopHostAttribute = null;
+    }
+    static { this.key = 'invisible-characters'; }
+    static setup(di) {
+        super.setup(di);
+        di.addImpl(InvisibleCharactersDisplayIdentifier, provider => provider.get(InvisibleCharacters));
+    }
+    /** Flip the display for this viewer. Answers the new state. */
+    toggle() {
+        const visible = !this.visible$.peek();
+        this._local$.value = visible;
+        this.std.getOptional(EditPropsStore)?.setStorage('showInvisibles', visible);
+        return visible;
+    }
+    mounted() {
+        super.mounted();
+        const stored = this.std
+            .getOptional(EditPropsStore)
+            ?.getStorage('showInvisibles');
+        this._local$.value = stored ?? undefined;
+        const host = this.std.host;
+        this._stopHostAttribute = effect(() => {
+            host.toggleAttribute(SHOW_INVISIBLES_ATTR, this.visible$.value);
+        });
+    }
+    unmounted() {
+        super.unmounted();
+        this._stopHostAttribute?.();
+        this._stopHostAttribute = null;
+    }
+}

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

@@ -3,17 +3,8 @@ import { type Container } from '../../../global/di/index.js';
 import { Extension, type ExtensionType } from '../../../store/index.js';
 import { z } from 'zod';
 export declare const LinkPreviewCacheConfigSchema: z.ZodObject<{
-    /**
-     * The maximum number of items in the cache
-     */
     cacheSize: z.ZodNumber;
-    /**
-     * The time to live for the memory cache
-     */
     memoryTTL: z.ZodNumber;
-    /**
-     * The time to live for the local storage cache
-     */
     localStorageTTL: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     cacheSize: number;

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-cache.js

@@ -5,17 +5,11 @@ import QuickLRU from 'quick-lru';
 import { z } from 'zod';
 import { LinkPreviewStorage } from './link-preview-storage.js';
 export const LinkPreviewCacheConfigSchema = z.object({
-    /**
-     * The maximum number of items in the cache
-     */
+    // The maximum number of items in the cache
     cacheSize: z.number(),
-    /**
-     * The time to live for the memory cache
-     */
+    // The time to live for the memory cache
     memoryTTL: z.number(),
-    /**
-     * The time to live for the local storage cache
-     */
+    // The time to live for the local storage cache
     localStorageTTL: z.number(),
 });
 const DEFAULT_LINK_PREVIEW_CACHE_CONFIG = {

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

@@ -389,3 +389,29 @@ export type CanvasPaneEvents = {
     CanvasGridToggled: CanvasGridToggledEvent;
     CanvasLayerChanged: CanvasLayerChangedEvent;
 };
+/**
+ * `text.invisibles.remove` stripped the invisible characters of the document
+ * (zero-width spaces, word joiners, tag characters…).
+ *
+ * `count` is how many characters the ONE gesture removed, `blockCount` how
+ * many blocks it changed (the canvas counts as one: its elements live in the
+ * surface block). A run that finds nothing reports nothing.
+ *
+ * Counts only: never a character, a block id or any text.
+ */
+export interface InvisibleCharactersRemovedEvent extends TelemetryEvent {
+    count: number;
+    blockCount: number;
+}
+/**
+ * `text.invisibles.toggle` switched "show special characters" for this
+ * viewer. `visible` is the state after the gesture. Nothing is written to
+ * the document.
+ */
+export interface InvisibleCharactersToggledEvent extends TelemetryEvent {
+    visible: boolean;
+}
+export type InvisibleCharactersEvents = {
+    InvisibleCharactersRemoved: InvisibleCharactersRemovedEvent;
+    InvisibleCharactersToggled: InvisibleCharactersToggledEvent;
+};

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, CanvasPaneEvents, DocumentHealthEvents, FrameworkDiagramEvents, ValidationEvents } from './lifecycle.js';
+import type { AuditEvents, BlockLifecycleEvents, CanvasPaneEvents, InvisibleCharactersEvents, 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 & CanvasPaneEvents & DocumentHealthEvents & {
+import type { AttachmentReloadedEvent, AttachmentReloadedEventInToolbar, AttachmentUpgradedEvent, AttachmentUploadedEvent, BlockCreationEvent, DocCreatedEvent, EdgelessToolPickedEvent, ElementCreationEvent, ElementLockEvent, ElementReplacedEvent, ElementUpdatedEvent, LatexEvent, LinkedDocCreatedEvent, LinkEvent, MindMapCollapseEvent, TelemetryEvent } from './types.js';
+export type TelemetryEventMap = OutDatabaseAllEvents & LinkToolbarEvents & SlashMenuEvents & CodeBlockEvents & NoteEvents & CitationEvents & BlockLifecycleEvents & FrameworkDiagramEvents & ValidationEvents & AuditEvents & CanvasPaneEvents & InvisibleCharactersEvents & DocumentHealthEvents & {
     DocCreated: DocCreatedEvent;
     Link: TelemetryEvent;
     LinkedDocCreated: LinkedDocCreatedEvent;
@@ -15,6 +15,7 @@ export type TelemetryEventMap = OutDatabaseAllEvents & LinkToolbarEvents & Slash
     CanvasElementAdded: ElementCreationEvent;
     CanvasElementUpdated: ElementUpdatedEvent;
     EdgelessElementLocked: ElementLockEvent;
+    ElementReplaced: ElementReplacedEvent;
     ExpandedAndCollapsed: MindMapCollapseEvent;
     AttachmentReloadedEvent: AttachmentReloadedEvent | AttachmentReloadedEventInToolbar;
     AttachmentUpgradedEvent: AttachmentUpgradedEvent;

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

@@ -37,6 +37,17 @@ export interface ElementLockEvent extends TelemetryEvent {
 export interface BlockCreationEvent extends TelemetryEvent {
     blockType: string;
 }
+/**
+ * A canvas model replaced by a model of another kind at its place (ADR 0044):
+ * a shape by an image, an image by a shape — or a canvas image's picture by
+ * another (`image` → `image`, amendment of 2026-10-27). Kinds only — never
+ * the ids, never the picture's `sourceId`, never content.
+ */
+export interface ElementReplacedEvent extends TelemetryEvent {
+    page?: 'whiteboard editor';
+    from: 'shape' | 'image';
+    to: 'shape' | 'image';
+}
 export interface MindMapCollapseEvent extends TelemetryEvent {
     page: 'whiteboard editor';
     segment: 'mind map';

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

@@ -13,6 +13,7 @@ export * from './file/index.js';
 export * from './fractional-indexing.js';
 export * from './image.js';
 export * from './insert.js';
+export * from './invisible-characters.js';
 export * from './is-abort-error.js';
 export * from './label-mode.js';
 export * from './link-preview-refresh.js';

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

@@ -13,6 +13,7 @@ export * from './file/index.js';
 export * from './fractional-indexing.js';
 export * from './image.js';
 export * from './insert.js';
+export * from './invisible-characters.js';
 export * from './is-abort-error.js';
 export * from './label-mode.js';
 export * from './link-preview-refresh.js';