@formicoidea/labre-core 0.43.1 → 0.45.0

package/dist/_pkgs/affine-inline-preset/command/config.js

@@ -1,9 +1,9 @@
-import { BoldIcon, CodeIcon, ItalicIcon, LinkIcon, StrikethroughIcon, UnderlineIcon, } from '../../affine-components/icons/index.js';
+import { BoldIcon, CodeIcon, ItalicIcon, LinkIcon, OverlineIcon, StrikethroughIcon, UnderlineIcon, } from '../../affine-components/icons/index.js';
 import { toggleLink } from '../../affine-inline-link/index.js';
 import {} from '../../affine-shared/services/index.js';
 import { TextSelection } from '../../std/index.js';
-import { isTextAttributeActive, toggleBold, toggleCode, toggleItalic, toggleStrike, toggleUnderline, } from './text-style.js';
-import { TEXT_FORMAT_BOLD, TEXT_FORMAT_CODE, TEXT_FORMAT_ITALIC, TEXT_FORMAT_LINK, TEXT_FORMAT_STRIKETHROUGH, TEXT_FORMAT_UNDERLINE, } from '../translations.js';
+import { isTextAttributeActive, toggleBold, toggleCode, toggleItalic, toggleOverline, toggleStrike, toggleUnderline, } from './text-style.js';
+import { TEXT_FORMAT_BOLD, TEXT_FORMAT_CODE, TEXT_FORMAT_ITALIC, TEXT_FORMAT_LINK, TEXT_FORMAT_OVERLINE, TEXT_FORMAT_STRIKETHROUGH, TEXT_FORMAT_UNDERLINE, } from '../translations.js';
 export const textFormatConfigs = [
     {
         id: 'bold',
@@ -56,6 +56,24 @@ export const textFormatConfigs = [
             host.std.command.chain().pipe(toggleUnderline).run();
         },
     },
+    {
+        // No default chord: `Mod-u` is underline's and none is free everywhere;
+        // a host binds one through the shortcuts pane (ADR 0030 §5).
+        id: 'overline',
+        name: 'Overline',
+        nameWording: TEXT_FORMAT_OVERLINE,
+        icon: OverlineIcon,
+        activeWhen: host => {
+            const [result] = host.std.command
+                .chain()
+                .pipe(isTextAttributeActive, { key: 'overline' })
+                .run();
+            return result;
+        },
+        action: host => {
+            host.std.command.chain().pipe(toggleOverline).run();
+        },
+    },
     {
         id: 'strike',
         name: 'Strikethrough',

package/dist/_pkgs/affine-inline-preset/command/index.d.ts

@@ -5,5 +5,5 @@ export { deleteTextCommand } from './delete-text.js';
 export { formatBlockCommand } from './format-block.js';
 export { formatNativeCommand } from './format-native.js';
 export { formatTextCommand } from './format-text.js';
-export { getTextAttributes, isTextAttributeActive, toggleBold, toggleCode, toggleItalic, toggleStrike, toggleTextStyleCommand, toggleUnderline, } from './text-style.js';
+export { getTextAttributes, isTextAttributeActive, toggleBold, toggleCode, toggleItalic, toggleOverline, toggleStrike, toggleTextStyleCommand, toggleUnderline, } from './text-style.js';
 export { isFormatSupported } from './utils.js';

package/dist/_pkgs/affine-inline-preset/command/index.js

@@ -4,5 +4,5 @@ export { deleteTextCommand } from './delete-text.js';
 export { formatBlockCommand } from './format-block.js';
 export { formatNativeCommand } from './format-native.js';
 export { formatTextCommand } from './format-text.js';
-export { getTextAttributes, isTextAttributeActive, toggleBold, toggleCode, toggleItalic, toggleStrike, toggleTextStyleCommand, toggleUnderline, } from './text-style.js';
+export { getTextAttributes, isTextAttributeActive, toggleBold, toggleCode, toggleItalic, toggleOverline, toggleStrike, toggleTextStyleCommand, toggleUnderline, } from './text-style.js';
 export { isFormatSupported } from './utils.js';

package/dist/_pkgs/affine-inline-preset/command/text-style.d.ts

@@ -1,11 +1,12 @@
 import type { AffineTextAttributes, AffineTextStyleAttributes } from '../../affine-shared/types/index.js';
 import type { Command } from '../../std/index.js';
 export declare const toggleTextStyleCommand: Command<{
-    key: Extract<keyof AffineTextStyleAttributes, 'bold' | 'italic' | 'underline' | 'strike' | 'code'>;
+    key: Extract<keyof AffineTextStyleAttributes, 'bold' | 'italic' | 'underline' | 'overline' | 'strike' | 'code'>;
 }>;
 export declare const toggleBold: Command;
 export declare const toggleItalic: Command;
 export declare const toggleUnderline: Command;
+export declare const toggleOverline: Command;
 export declare const toggleStrike: Command;
 export declare const toggleCode: Command;
 export declare const getTextAttributes: Command<{}, {

package/dist/_pkgs/affine-inline-preset/command/text-style.js

@@ -41,6 +41,7 @@ const toggleTextStyleCommandWrapper = (key) => {
 export const toggleBold = toggleTextStyleCommandWrapper('bold');
 export const toggleItalic = toggleTextStyleCommandWrapper('italic');
 export const toggleUnderline = toggleTextStyleCommandWrapper('underline');
+export const toggleOverline = toggleTextStyleCommandWrapper('overline');
 export const toggleStrike = toggleTextStyleCommandWrapper('strike');
 export const toggleCode = toggleTextStyleCommandWrapper('code');
 export const getTextAttributes = (ctx, next) => {

package/dist/_pkgs/affine-inline-preset/default-inline-manager.js

@@ -5,13 +5,14 @@ import { LinkInlineSpecExtension } from '../affine-inline-link/index.js';
 import { MentionInlineSpecExtension } from '../affine-inline-mention/index.js';
 import { ReferenceInlineSpecExtension } from '../affine-inline-reference/index.js';
 import { InlineManagerExtension } from '../std/inline/index.js';
-import { BackgroundInlineSpecExtension, BoldInlineSpecExtension, CodeInlineSpecExtension, ColorInlineSpecExtension, ItalicInlineSpecExtension, StrikeInlineSpecExtension, UnderlineInlineSpecExtension, } from './inline-spec.js';
+import { BackgroundInlineSpecExtension, BoldInlineSpecExtension, CodeInlineSpecExtension, ColorInlineSpecExtension, ItalicInlineSpecExtension, OverlineInlineSpecExtension, StrikeInlineSpecExtension, UnderlineInlineSpecExtension, } from './inline-spec.js';
 export const DefaultInlineManagerExtension = InlineManagerExtension({
     id: 'DefaultInlineManager',
     specs: [
         BoldInlineSpecExtension.identifier,
         ItalicInlineSpecExtension.identifier,
         UnderlineInlineSpecExtension.identifier,
+        OverlineInlineSpecExtension.identifier,
         StrikeInlineSpecExtension.identifier,
         CodeInlineSpecExtension.identifier,
         BackgroundInlineSpecExtension.identifier,

package/dist/_pkgs/affine-inline-preset/inline-spec.d.ts

@@ -11,6 +11,10 @@ export declare const ItalicInlineSpecExtension: ExtensionType & {
 export declare const UnderlineInlineSpecExtension: ExtensionType & {
     identifier: import("../global/di/types.js").ServiceIdentifier<import("../std/inline/index.js").InlineSpecs<AffineTextAttributes>>;
 };
+/** Underline's twin, declared at the affine level only (ADR 0030 §5). */
+export declare const OverlineInlineSpecExtension: ExtensionType & {
+    identifier: import("../global/di/types.js").ServiceIdentifier<import("../std/inline/index.js").InlineSpecs<AffineTextAttributes>>;
+};
 export declare const StrikeInlineSpecExtension: ExtensionType & {
     identifier: import("../global/di/types.js").ServiceIdentifier<import("../std/inline/index.js").InlineSpecs<AffineTextAttributes>>;
 };

package/dist/_pkgs/affine-inline-preset/inline-spec.js

@@ -37,6 +37,19 @@ export const UnderlineInlineSpecExtension = InlineSpecExtension({
         return html `<affine-text .delta=${delta}></affine-text>`;
     },
 });
+/** Underline's twin, declared at the affine level only (ADR 0030 §5). */
+export const OverlineInlineSpecExtension = InlineSpecExtension({
+    name: 'overline',
+    schema: z.object({
+        overline: z.literal(true).optional().nullable().catch(undefined),
+    }),
+    match: delta => {
+        return !!delta.attributes?.overline;
+    },
+    renderer: ({ delta }) => {
+        return html `<affine-text .delta=${delta}></affine-text>`;
+    },
+});
 export const StrikeInlineSpecExtension = InlineSpecExtension({
     name: 'strike',
     schema: z.object({
@@ -89,6 +102,7 @@ export const InlineSpecExtensions = [
     BoldInlineSpecExtension,
     ItalicInlineSpecExtension,
     UnderlineInlineSpecExtension,
+    OverlineInlineSpecExtension,
     StrikeInlineSpecExtension,
     CodeInlineSpecExtension,
     BackgroundInlineSpecExtension,

package/dist/_pkgs/affine-inline-preset/translations.d.ts

@@ -1,4 +1,4 @@
-import { type ChromeWording, TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_STRIKETHROUGH, TEXT_FORMAT_UNDERLINE } from '../affine-shared/services/index.js';
+import { type ChromeWording, TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_OVERLINE, TEXT_FORMAT_STRIKETHROUGH, TEXT_FORMAT_UNDERLINE } from '../affine-shared/services/index.js';
 /**
  * `@labre/affine-inline-preset`'s own wordings — `command/config.ts`'s
  * `textFormatConfigs`. This is DATA (no `std` of its own): `name` is
@@ -14,7 +14,7 @@ import { type ChromeWording, TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_S
  * re-exported here under this package's own name; only "Code" stays this
  * format's own.
  */
-export { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_UNDERLINE, TEXT_FORMAT_STRIKETHROUGH, };
+export { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_UNDERLINE, TEXT_FORMAT_OVERLINE, TEXT_FORMAT_STRIKETHROUGH, };
 export declare const TEXT_FORMAT_CODE: ChromeWording;
 export declare const TEXT_FORMAT_LINK: ChromeWording;
 /**

package/dist/_pkgs/affine-inline-preset/translations.js

@@ -1,4 +1,4 @@
-import { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_STRIKETHROUGH, TEXT_FORMAT_UNDERLINE, TOOLBAR_LINK, } from '../affine-shared/services/index.js';
+import { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_OVERLINE, TEXT_FORMAT_STRIKETHROUGH, TEXT_FORMAT_UNDERLINE, TOOLBAR_LINK, } from '../affine-shared/services/index.js';
 /**
  * `@labre/affine-inline-preset`'s own wordings — `command/config.ts`'s
  * `textFormatConfigs`. This is DATA (no `std` of its own): `name` is
@@ -14,7 +14,7 @@ import { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_STRIKETHROUGH, TEXT_F
  * re-exported here under this package's own name; only "Code" stays this
  * format's own.
  */
-export { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_UNDERLINE, TEXT_FORMAT_STRIKETHROUGH, };
+export { TEXT_FORMAT_BOLD, TEXT_FORMAT_ITALIC, TEXT_FORMAT_UNDERLINE, TEXT_FORMAT_OVERLINE, TEXT_FORMAT_STRIKETHROUGH, };
 export const TEXT_FORMAT_CODE = [
     'com.labre.text-format.code',
     'Code',

package/dist/_pkgs/affine-model/blocks/attachment/attachment-model.js

@@ -18,6 +18,8 @@ export const defaultAttachmentProps = {
     index: 'a0',
     xywh: '[0,0,0,0]',
     lockedBySelf: false,
+    hiddenForEveryone: undefined,
+    layer: undefined,
     rotate: 0,
     'meta:createdAt': undefined,
     'meta:updatedAt': undefined,

package/dist/_pkgs/affine-model/blocks/bookmark/bookmark-model.js

@@ -18,6 +18,8 @@ const defaultBookmarkProps = {
     index: 'a0',
     xywh: '[0,0,0,0]',
     lockedBySelf: false,
+    hiddenForEveryone: undefined,
+    layer: undefined,
     rotate: 0,
     'meta:createdAt': undefined,
     'meta:updatedAt': undefined,

package/dist/_pkgs/affine-model/blocks/edgeless-text/edgeless-text-model.d.ts

@@ -4,7 +4,7 @@ import { FontFamily, FontStyle, FontWeight, TextAlign, type TextStyleProps } fro
 type EdgelessTextProps = {
     hasMaxWidth: boolean;
     comments?: Record<string, boolean>;
-} & Omit<TextStyleProps, 'fontSize'> & GfxCommonBlockProps;
+} & Omit<TextStyleProps, 'fontSize' | 'textDecoration'> & GfxCommonBlockProps;
 export declare const EdgelessTextZodSchema: z.ZodDefault<z.ZodObject<{
     color: z.ZodUnion<[z.ZodString, z.ZodObject<{
         normal: z.ZodString;

package/dist/_pkgs/affine-model/blocks/edgeless-text/edgeless-text-model.js

@@ -25,6 +25,8 @@ export const EdgelessTextBlockSchema = defineBlockSchema({
         xywh: '[0,0,16,16]',
         index: 'a0',
         lockedBySelf: false,
+        hiddenForEveryone: undefined,
+        layer: undefined,
         scale: 1,
         rotate: 0,
         hasMaxWidth: false,

package/dist/_pkgs/affine-model/blocks/embed/iframe/iframe-model.js

@@ -13,6 +13,8 @@ export const defaultEmbedIframeProps = {
     xywh: '[0,0,0,0]',
     index: 'a0',
     lockedBySelf: false,
+    hiddenForEveryone: undefined,
+    layer: undefined,
     scale: 1,
 };
 export class EmbedIframeBlockModel extends GfxCompatible(BlockModel) {

package/dist/_pkgs/affine-model/blocks/frame/frame-model.js

@@ -21,6 +21,8 @@ export const FrameBlockSchema = defineBlockSchema({
         childElementIds: Object.create(null),
         presentationIndex: generateKeyBetweenV2(null, null),
         lockedBySelf: false,
+        hiddenForEveryone: undefined,
+        layer: undefined,
         comments: undefined,
     }),
     metadata: {

package/dist/_pkgs/affine-model/blocks/image/image-model.js

@@ -9,6 +9,8 @@ const defaultImageProps = {
     index: 'a0',
     xywh: '[0,0,0,0]',
     lockedBySelf: false,
+    hiddenForEveryone: undefined,
+    layer: undefined,
     rotate: 0,
     size: -1,
     comments: undefined,

package/dist/_pkgs/affine-model/blocks/latex/latex-model.js

@@ -6,6 +6,8 @@ export const LatexBlockSchema = defineBlockSchema({
         xywh: '[0,0,16,16]',
         index: 'a0',
         lockedBySelf: false,
+        hiddenForEveryone: undefined,
+        layer: undefined,
         scale: 1,
         rotate: 0,
         latex: '',

package/dist/_pkgs/affine-model/blocks/note/note-model.js

@@ -36,6 +36,8 @@ export const NoteBlockSchema = defineBlockSchema({
         background: DefaultTheme.noteBackgrounColor,
         index: 'a0',
         lockedBySelf: false,
+        hiddenForEveryone: undefined,
+        layer: undefined,
         hidden: false,
         displayMode: NoteDisplayMode.DocAndEdgeless,
         edgeless: {

package/dist/_pkgs/affine-model/consts/text.d.ts

@@ -11,6 +11,30 @@ export declare enum TextVerticalAlign {
     Center = "center",
     Top = "top"
 }
+/**
+ * The line a canvas text is decorated with, as a CSS `text-decoration-line`
+ * token list (ADR 0030).
+ *
+ * **These string values are PERSISTED** — on a `text`, on a `shape` and inside
+ * a connector's `labelStyle` — so the enum is **append-only**: a member may be
+ * added, never renamed, never removed, never given a different string value.
+ *
+ * Readers split the value on whitespace and act on the tokens they know, never
+ * `switch` on the whole string: a token a newer client adds (`line-through`,
+ * say) is skipped by this build one token at a time, so
+ * `'underline line-through'` still paints its underline here.
+ *
+ * `undefined` (the key absent) and `None` paint the same on every element. They
+ * differ for one reader only — the UML object glyph's legacy rule, drawn for a
+ * name that never carried the field — which is why turning the decoration off
+ * writes `None` rather than clearing the key.
+ */
+export declare enum TextDecoration {
+    None = "none",
+    Underline = "underline",
+    Overline = "overline",
+    UnderlineOverline = "underline overline"
+}
 export type TextStyleProps = {
     color: Color;
     fontFamily: FontFamily;
@@ -18,6 +42,8 @@ export type TextStyleProps = {
     fontStyle: FontStyle;
     fontWeight: FontWeight;
     textAlign: TextAlign;
+    /** Optional and never written by default: see {@link TextDecoration}. */
+    textDecoration?: TextDecoration;
 };
 export declare enum FontWeight {
     Bold = "700",

package/dist/_pkgs/affine-model/consts/text.js

@@ -13,6 +13,31 @@ export var TextVerticalAlign;
     TextVerticalAlign["Center"] = "center";
     TextVerticalAlign["Top"] = "top";
 })(TextVerticalAlign || (TextVerticalAlign = {}));
+/**
+ * The line a canvas text is decorated with, as a CSS `text-decoration-line`
+ * token list (ADR 0030).
+ *
+ * **These string values are PERSISTED** — on a `text`, on a `shape` and inside
+ * a connector's `labelStyle` — so the enum is **append-only**: a member may be
+ * added, never renamed, never removed, never given a different string value.
+ *
+ * Readers split the value on whitespace and act on the tokens they know, never
+ * `switch` on the whole string: a token a newer client adds (`line-through`,
+ * say) is skipped by this build one token at a time, so
+ * `'underline line-through'` still paints its underline here.
+ *
+ * `undefined` (the key absent) and `None` paint the same on every element. They
+ * differ for one reader only — the UML object glyph's legacy rule, drawn for a
+ * name that never carried the field — which is why turning the decoration off
+ * writes `None` rather than clearing the key.
+ */
+export var TextDecoration;
+(function (TextDecoration) {
+    TextDecoration["None"] = "none";
+    TextDecoration["Underline"] = "underline";
+    TextDecoration["Overline"] = "overline";
+    TextDecoration["UnderlineOverline"] = "underline overline";
+})(TextDecoration || (TextDecoration = {}));
 export var FontWeight;
 (function (FontWeight) {
     FontWeight["Bold"] = "700";

package/dist/_pkgs/affine-model/elements/shape/shape.d.ts

@@ -3,7 +3,7 @@ import { Bound } from '../../../global/gfx/index.js';
 import type { BaseElementProps, PointTestOptions } from '../../../std/gfx/index.js';
 import { GfxLocalElementModel, GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
 import * as Y from 'yjs';
-import { FontStyle, FontWeight, ShapeStyle, ShapeType, StrokeStyle, TextAlign, TextFitMode, TextResizing, type TextStyleProps, TextVerticalAlign } from '../../consts/index.js';
+import { FontStyle, FontWeight, ShapeStyle, ShapeType, StrokeStyle, TextAlign, type TextDecoration, TextFitMode, TextResizing, type TextStyleProps, TextVerticalAlign } from '../../consts/index.js';
 import { type Color } from '../../themes/index.js';
 export type ShapeProps = BaseElementProps & {
     shapeType: ShapeType;
@@ -98,6 +98,11 @@ export declare class ShapeElementModel extends GfxPrimitiveElementModel<ShapePro
     accessor strokeWidth: number;
     accessor text: Y.Text | undefined;
     accessor textAlign: TextAlign;
+    /**
+     * Absent until the author sets it, so a shape whose text is never decorated
+     * stores exactly the keys it stored before the field existed (ADR 0030).
+     */
+    accessor textDecoration: TextDecoration | undefined;
     accessor textDisplay: boolean;
     accessor textHorizontalAlign: TextAlign;
     accessor textResizing: TextResizing;

package/dist/_pkgs/affine-model/elements/shape/shape.js

@@ -102,6 +102,9 @@ let ShapeElementModel = (() => {
     let _textAlign_decorators;
     let _textAlign_initializers = [];
     let _textAlign_extraInitializers = [];
+    let _textDecoration_decorators;
+    let _textDecoration_initializers = [];
+    let _textDecoration_extraInitializers = [];
     let _textDisplay_decorators;
     let _textDisplay_initializers = [];
     let _textDisplay_extraInitializers = [];
@@ -155,6 +158,7 @@ let ShapeElementModel = (() => {
             _strokeWidth_decorators = [field()];
             _text_decorators = [field()];
             _textAlign_decorators = [field(TextAlign.Center)];
+            _textDecoration_decorators = [field()];
             _textDisplay_decorators = [local()];
             _textHorizontalAlign_decorators = [field(TextAlign.Center)];
             _textResizing_decorators = [field(TextResizing.AUTO_HEIGHT)];
@@ -185,6 +189,7 @@ let ShapeElementModel = (() => {
             __esDecorate(this, null, _strokeWidth_decorators, { kind: "accessor", name: "strokeWidth", static: false, private: false, access: { has: obj => "strokeWidth" in obj, get: obj => obj.strokeWidth, set: (obj, value) => { obj.strokeWidth = value; } }, metadata: _metadata }, _strokeWidth_initializers, _strokeWidth_extraInitializers);
             __esDecorate(this, null, _text_decorators, { kind: "accessor", name: "text", static: false, private: false, access: { has: obj => "text" in obj, get: obj => obj.text, set: (obj, value) => { obj.text = value; } }, metadata: _metadata }, _text_initializers, _text_extraInitializers);
             __esDecorate(this, null, _textAlign_decorators, { kind: "accessor", name: "textAlign", static: false, private: false, access: { has: obj => "textAlign" in obj, get: obj => obj.textAlign, set: (obj, value) => { obj.textAlign = value; } }, metadata: _metadata }, _textAlign_initializers, _textAlign_extraInitializers);
+            __esDecorate(this, null, _textDecoration_decorators, { kind: "accessor", name: "textDecoration", static: false, private: false, access: { has: obj => "textDecoration" in obj, get: obj => obj.textDecoration, set: (obj, value) => { obj.textDecoration = value; } }, metadata: _metadata }, _textDecoration_initializers, _textDecoration_extraInitializers);
             __esDecorate(this, null, _textDisplay_decorators, { kind: "accessor", name: "textDisplay", static: false, private: false, access: { has: obj => "textDisplay" in obj, get: obj => obj.textDisplay, set: (obj, value) => { obj.textDisplay = value; } }, metadata: _metadata }, _textDisplay_initializers, _textDisplay_extraInitializers);
             __esDecorate(this, null, _textHorizontalAlign_decorators, { kind: "accessor", name: "textHorizontalAlign", static: false, private: false, access: { has: obj => "textHorizontalAlign" in obj, get: obj => obj.textHorizontalAlign, set: (obj, value) => { obj.textHorizontalAlign = value; } }, metadata: _metadata }, _textHorizontalAlign_initializers, _textHorizontalAlign_extraInitializers);
             __esDecorate(this, null, _textResizing_decorators, { kind: "accessor", name: "textResizing", static: false, private: false, access: { has: obj => "textResizing" in obj, get: obj => obj.textResizing, set: (obj, value) => { obj.textResizing = value; } }, metadata: _metadata }, _textResizing_initializers, _textResizing_extraInitializers);
@@ -306,6 +311,13 @@ let ShapeElementModel = (() => {
         #textAlign_accessor_storage;
         get textAlign() { return this.#textAlign_accessor_storage; }
         set textAlign(value) { this.#textAlign_accessor_storage = value; }
+        #textDecoration_accessor_storage;
+        /**
+         * Absent until the author sets it, so a shape whose text is never decorated
+         * stores exactly the keys it stored before the field existed (ADR 0030).
+         */
+        get textDecoration() { return this.#textDecoration_accessor_storage; }
+        set textDecoration(value) { this.#textDecoration_accessor_storage = value; }
         #textDisplay_accessor_storage;
         get textDisplay() { return this.#textDisplay_accessor_storage; }
         set textDisplay(value) { this.#textDisplay_accessor_storage = value; }
@@ -397,7 +409,8 @@ let ShapeElementModel = (() => {
             this.#strokeWidth_accessor_storage = (__runInitializers(this, _strokeStyle_extraInitializers), __runInitializers(this, _strokeWidth_initializers, 4));
             this.#text_accessor_storage = (__runInitializers(this, _strokeWidth_extraInitializers), __runInitializers(this, _text_initializers, undefined));
             this.#textAlign_accessor_storage = (__runInitializers(this, _text_extraInitializers), __runInitializers(this, _textAlign_initializers, void 0));
-            this.#textDisplay_accessor_storage = (__runInitializers(this, _textAlign_extraInitializers), __runInitializers(this, _textDisplay_initializers, true));
+            this.#textDecoration_accessor_storage = (__runInitializers(this, _textAlign_extraInitializers), __runInitializers(this, _textDecoration_initializers, undefined));
+            this.#textDisplay_accessor_storage = (__runInitializers(this, _textDecoration_extraInitializers), __runInitializers(this, _textDisplay_initializers, true));
             this.#textHorizontalAlign_accessor_storage = (__runInitializers(this, _textDisplay_extraInitializers), __runInitializers(this, _textHorizontalAlign_initializers, void 0));
             this.#textResizing_accessor_storage = (__runInitializers(this, _textHorizontalAlign_extraInitializers), __runInitializers(this, _textResizing_initializers, TextResizing.AUTO_HEIGHT));
             this.#textFitMode_accessor_storage = (__runInitializers(this, _textResizing_extraInitializers), __runInitializers(this, _textFitMode_initializers, TextFitMode.Grow));

package/dist/_pkgs/affine-model/elements/text/text.d.ts

@@ -3,7 +3,7 @@ import { Bound } from '../../../global/gfx/index.js';
 import type { BaseElementProps } from '../../../std/gfx/index.js';
 import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
 import * as Y from 'yjs';
-import { FontFamily, FontStyle, FontWeight, TextAlign, type TextStyleProps } from '../../consts/index.js';
+import { FontFamily, FontStyle, FontWeight, TextAlign, type TextDecoration, type TextStyleProps } from '../../consts/index.js';
 import { type Color } from '../../themes/index.js';
 export type TextElementProps = BaseElementProps & {
     text: Y.Text;
@@ -25,5 +25,10 @@ export declare class TextElementModel extends GfxPrimitiveElementModel<TextEleme
     accessor rotate: number;
     accessor text: Y.Text;
     accessor textAlign: TextAlign;
+    /**
+     * Absent until the author sets it, so a text that is never decorated stores
+     * exactly the keys it stored before the field existed (ADR 0030).
+     */
+    accessor textDecoration: TextDecoration | undefined;
     accessor xywh: SerializedXYWH;
 }

package/dist/_pkgs/affine-model/elements/text/text.js

@@ -66,6 +66,9 @@ let TextElementModel = (() => {
     let _textAlign_decorators;
     let _textAlign_initializers = [];
     let _textAlign_extraInitializers = [];
+    let _textDecoration_decorators;
+    let _textDecoration_initializers = [];
+    let _textDecoration_extraInitializers = [];
     let _xywh_decorators;
     let _xywh_initializers = [];
     let _xywh_extraInitializers = [];
@@ -81,6 +84,7 @@ let TextElementModel = (() => {
             _rotate_decorators = [field(0)];
             _text_decorators = [field()];
             _textAlign_decorators = [field()];
+            _textDecoration_decorators = [field()];
             _xywh_decorators = [field('[0,0,0,0]')];
             __esDecorate(this, null, _color_decorators, { kind: "accessor", name: "color", static: false, private: false, access: { has: obj => "color" in obj, get: obj => obj.color, set: (obj, value) => { obj.color = value; } }, metadata: _metadata }, _color_initializers, _color_extraInitializers);
             __esDecorate(this, null, _fontFamily_decorators, { kind: "accessor", name: "fontFamily", static: false, private: false, access: { has: obj => "fontFamily" in obj, get: obj => obj.fontFamily, set: (obj, value) => { obj.fontFamily = value; } }, metadata: _metadata }, _fontFamily_initializers, _fontFamily_extraInitializers);
@@ -91,6 +95,7 @@ let TextElementModel = (() => {
             __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, _text_decorators, { kind: "accessor", name: "text", static: false, private: false, access: { has: obj => "text" in obj, get: obj => obj.text, set: (obj, value) => { obj.text = value; } }, metadata: _metadata }, _text_initializers, _text_extraInitializers);
             __esDecorate(this, null, _textAlign_decorators, { kind: "accessor", name: "textAlign", static: false, private: false, access: { has: obj => "textAlign" in obj, get: obj => obj.textAlign, set: (obj, value) => { obj.textAlign = value; } }, metadata: _metadata }, _textAlign_initializers, _textAlign_extraInitializers);
+            __esDecorate(this, null, _textDecoration_decorators, { kind: "accessor", name: "textDecoration", static: false, private: false, access: { has: obj => "textDecoration" in obj, get: obj => obj.textDecoration, set: (obj, value) => { obj.textDecoration = value; } }, metadata: _metadata }, _textDecoration_initializers, _textDecoration_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);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
@@ -145,7 +150,14 @@ let TextElementModel = (() => {
         #textAlign_accessor_storage = (__runInitializers(this, _text_extraInitializers), __runInitializers(this, _textAlign_initializers, TextAlign.Center));
         get textAlign() { return this.#textAlign_accessor_storage; }
         set textAlign(value) { this.#textAlign_accessor_storage = value; }
-        #xywh_accessor_storage = (__runInitializers(this, _textAlign_extraInitializers), __runInitializers(this, _xywh_initializers, '[0,0,16,16]'));
+        #textDecoration_accessor_storage = (__runInitializers(this, _textAlign_extraInitializers), __runInitializers(this, _textDecoration_initializers, undefined));
+        /**
+         * Absent until the author sets it, so a text that is never decorated stores
+         * exactly the keys it stored before the field existed (ADR 0030).
+         */
+        get textDecoration() { return this.#textDecoration_accessor_storage; }
+        set textDecoration(value) { this.#textDecoration_accessor_storage = value; }
+        #xywh_accessor_storage = (__runInitializers(this, _textDecoration_extraInitializers), __runInitializers(this, _xywh_initializers, '[0,0,16,16]'));
         get xywh() { return this.#xywh_accessor_storage; }
         set xywh(value) { this.#xywh_accessor_storage = value; }
         constructor() {

package/dist/_pkgs/affine-model/utils/helper.js

@@ -12,6 +12,8 @@ export function createEmbedBlockSchema({ name, version, toModel, props, transfor
                 index: 'a0',
                 xywh: '[0,0,0,0]',
                 lockedBySelf: false,
+                hiddenForEveryone: undefined,
+                layer: undefined,
                 rotate: 0,
                 comments: undefined,
                 'meta:createdAt': undefined,

package/dist/_pkgs/affine-rich-text/conversion.d.ts

@@ -1,4 +1,6 @@
 import { type ChromeWording } from '../affine-shared/services/index.js';
+import type { BlockStdScope } from '../std/index.js';
+import type { BlockModel, ExtensionType } from '../store/index.js';
 import type { TemplateResult } from 'lit';
 /**
  * Text primitive entries used in slash menu and format bar,
@@ -25,3 +27,26 @@ export interface TextConversionConfig {
     descriptionWording?: ChromeWording;
 }
 export declare const textConversionConfigs: TextConversionConfig[];
+/**
+ * A "Turn into" entry contributed by a block package from its OWN view
+ * extension, for a conversion `updateBlockType` cannot carry (#418).
+ *
+ * `textConversionConfigs` above is static and unconditional: every entry in it
+ * is offered whatever the host's flags say. A block whose tooling is
+ * flag-gated (ADR 0009) therefore cannot be listed there; it registers this
+ * entry from its gated view extension instead, so `{ callout: false }` removes
+ * the entry with the rest of the callout's tooling. Mirrors
+ * `SlashMenuConfigExtension`: one DI variant per flavour, read with `getAll`
+ * by the menu that draws the entries.
+ */
+export interface TextConversionEntry {
+    flavour: string;
+    name: string;
+    nameWording: ChromeWording;
+    icon: TemplateResult;
+    /** Whether the entry is offered for the models currently selected. */
+    when: (std: BlockStdScope, models: BlockModel[]) => boolean;
+    run: (std: BlockStdScope, models: BlockModel[]) => void;
+}
+export declare const TextConversionEntryIdentifier: import("../global/di/types.js").ServiceIdentifier<TextConversionEntry> & (<U extends TextConversionEntry = TextConversionEntry>(variant: import("../global/di/types.js").ServiceVariant) => import("../global/di/types.js").ServiceIdentifier<U>);
+export declare function TextConversionEntryExtension(entry: TextConversionEntry): ExtensionType;

package/dist/_pkgs/affine-rich-text/conversion.js

@@ -1,5 +1,6 @@
 import { BulletedListIcon, CheckBoxIcon, CodeBlockIcon, DividerIcon, Heading1Icon, Heading2Icon, Heading3Icon, Heading4Icon, Heading5Icon, Heading6Icon, NumberedListIcon, QuoteIcon, TextIcon, } from '../affine-components/icons/index.js';
 import { BLOCK_TYPE_BULLETED_LIST, BLOCK_TYPE_BULLETED_LIST_DESCRIPTION, BLOCK_TYPE_CODE_BLOCK, BLOCK_TYPE_CODE_BLOCK_DESCRIPTION, BLOCK_TYPE_DIVIDER, BLOCK_TYPE_DIVIDER_DESCRIPTION, BLOCK_TYPE_HEADING_1, BLOCK_TYPE_HEADING_1_DESCRIPTION, BLOCK_TYPE_HEADING_2, BLOCK_TYPE_HEADING_2_DESCRIPTION, BLOCK_TYPE_HEADING_3, BLOCK_TYPE_HEADING_3_DESCRIPTION, BLOCK_TYPE_HEADING_4, BLOCK_TYPE_HEADING_4_DESCRIPTION, BLOCK_TYPE_HEADING_5, BLOCK_TYPE_HEADING_5_DESCRIPTION, BLOCK_TYPE_HEADING_6, BLOCK_TYPE_HEADING_6_DESCRIPTION, BLOCK_TYPE_NUMBERED_LIST, BLOCK_TYPE_NUMBERED_LIST_DESCRIPTION, BLOCK_TYPE_QUOTE, BLOCK_TYPE_QUOTE_DESCRIPTION, BLOCK_TYPE_TEXT, BLOCK_TYPE_TEXT_DESCRIPTION, BLOCK_TYPE_TODO_LIST, BLOCK_TYPE_TODO_LIST_DESCRIPTION, } from '../affine-shared/services/index.js';
+import { createIdentifier } from '../global/di/index.js';
 export const textConversionConfigs = [
     {
         flavour: 'affine:paragraph',
@@ -132,3 +133,11 @@ export const textConversionConfigs = [
         descriptionWording: BLOCK_TYPE_DIVIDER_DESCRIPTION,
     },
 ];
+export const TextConversionEntryIdentifier = createIdentifier('AffineTextConversionEntry');
+export function TextConversionEntryExtension(entry) {
+    return {
+        setup: di => {
+            di.addImpl(TextConversionEntryIdentifier(entry.flavour), entry);
+        },
+    };
+}

package/dist/_pkgs/affine-rich-text/index.d.ts

@@ -1,4 +1,4 @@
-export { type TextConversionConfig, textConversionConfigs } from './conversion.js';
+export { type TextConversionConfig, textConversionConfigs, type TextConversionEntry, TextConversionEntryExtension, TextConversionEntryIdentifier, } from './conversion.js';
 export { asyncGetRichText, asyncSetInlineRange, cleanSpecifiedTail, focusTextModel, getInlineEditorByModel, getRichTextByModel, getTextContentFromInlineRange, onModelTextUpdated, selectTextModel, } from './dom.js';
 export { RichText } from './rich-text.js';
 export * from './utils.js';

package/dist/_pkgs/affine-rich-text/index.js

@@ -1,4 +1,4 @@
-export { textConversionConfigs } from './conversion.js';
+export { textConversionConfigs, TextConversionEntryExtension, TextConversionEntryIdentifier, } from './conversion.js';
 export { asyncGetRichText, asyncSetInlineRange, cleanSpecifiedTail, focusTextModel, getInlineEditorByModel, getRichTextByModel, getTextContentFromInlineRange, onModelTextUpdated, selectTextModel, } from './dom.js';
 export { RichText } from './rich-text.js';
 export * from './utils.js';

package/dist/_pkgs/affine-shared/commands/model-crud/replace-selected-text-with-blocks.d.ts

@@ -1,5 +1,5 @@
-import type { BlockModel } from '../../../../store/index.js';
 import type { Command, TextSelection } from '../../../std/index.js';
+import type { BlockModel } from '../../../store/index.js';
 /**
  * Replace the selected text with the given blocks
  *

package/dist/_pkgs/affine-shared/services/canvas-grid.d.ts

@@ -0,0 +1,63 @@
+import { LifeCycleWatcher } from '../../std/index.js';
+import { type SurfaceBlockModel } from '../../std/gfx/index.js';
+import { type ReadonlySignal } from '@preact/signals-core';
+/** Who decided the grid this viewer sees (ADR 0031 §11). */
+export type CanvasGridSource = 'local' | 'document' | 'host' | 'library';
+/**
+ * The four levels of ADR 0031 §11, nearest decision first: the viewer's own
+ * override, the document's "saved for everyone" setting, the host's default
+ * (`edgelessShowGrid`), and the library default — on. `undefined` at a level
+ * means "nobody decided here".
+ */
+export declare function resolveCanvasGrid(levels: {
+    local?: boolean;
+    document?: boolean;
+    host?: boolean;
+}): {
+    visible: boolean;
+    source: CanvasGridSource;
+};
+/**
+ * What a surface stored for everyone, read reactively. Previews (the
+ * read-only edgeless preview, a surface-ref) follow THIS and the library
+ * default only: they are a picture of the document, not a viewer's session,
+ * so neither a viewer override nor a host default reaches them.
+ */
+export declare function documentShowsGrid(surface: SurfaceBlockModel | null | undefined): boolean;
+/**
+ * The canvas grid as THIS viewer sees it (ADR 0031 §11).
+ *
+ * - **The toggle is local**: it writes the viewer's override, an
+ *   `EditPropsStore` `localStorage` prop keyed by document id like the
+ *   viewport, so it survives a reload and produces no Yjs update — a reader
+ *   may toggle it too.
+ * - **"Save for everyone"** writes the current state into the surface's
+ *   `showGrid` and clears the saver's override, so they see what everyone
+ *   sees. Refused on a read-only store; writes nothing when the document
+ *   already says the same.
+ *
+ * Both containers that paint the grid (the edgeless root's background and
+ * the surface container) and the PNG export read `visible$`.
+ */
+export declare class CanvasGrid extends LifeCycleWatcher {
+    static key: string;
+    private readonly _local$;
+    private readonly _resolved$;
+    /** Whether this viewer sees the grid. */
+    readonly visible$: ReadonlySignal<boolean>;
+    /** Which level decided `visible$`. */
+    readonly source$: ReadonlySignal<CanvasGridSource>;
+    private _surface;
+    /**
+     * Flip the grid for this viewer only. Answers the new visibility.
+     */
+    toggle(): boolean;
+    /**
+     * Store what this viewer sees as the document's setting, and drop their
+     * override. Answers the saved value, or `null` when nothing was written
+     * (read-only store, no surface, or the document already said so).
+     */
+    saveForEveryone(): boolean | null;
+    private _clearLocal;
+    mounted(): void;
+}