@sobree/core 0.1.15 → 0.1.16

package/dist/doc/builders/index.d.ts

@@ -23,3 +23,4 @@ export { heading, paragraph, sectionBreak } from './block';
 export { columnBreak, commentRef, emphasis, field, footnoteRef, hyperlink, image, type ImageOptions, pageBreak, softBreak, strong, tab, text, } from './inline';
 export { type CellProperties, type TableOptions, table, tableCell, tableRow } from './table';
 export { type NamedStyleOptions, namedStyle } from './style';
+export { type NumberingLevelOptions, bulletDefinition, numberingDefinition, numberingLevel, orderedDefinition, } from './numbering';

package/dist/doc/builders/numbering.d.ts

@@ -0,0 +1,19 @@
+import { NumberingDefinition, NumberingLevel, ParagraphIndent, RunProperties } from '../types';
+export interface NumberingLevelOptions {
+    restart?: number;
+    paragraphIndent?: ParagraphIndent;
+    /** Run properties for the marker glyph/number itself. */
+    runDefaults?: RunProperties;
+}
+/** One indent level of a list. `format` is `bullet` / `decimal` /
+ *  `lowerRoman` / `upperLetter` / …; `text` is the marker template
+ *  (`%1.`, `(%1)`, or a literal bullet glyph). */
+export declare function numberingLevel(level: number, format: string, text: string, options?: NumberingLevelOptions): NumberingLevel;
+/** A numbering definition: a `numId` (referenced from paragraphs) plus its
+ *  level formats. */
+export declare function numberingDefinition(numId: number, levels: NumberingLevel[]): NumberingDefinition;
+/** A bullet list of `levels` levels (default 3), cycling • ◦ ▪. */
+export declare function bulletDefinition(numId: number, levels?: number): NumberingDefinition;
+/** An ordered list of `levels` levels (default 3), each `%1.` decimal,
+ *  restarting at the level above. */
+export declare function orderedDefinition(numId: number, levels?: number): NumberingDefinition;

package/dist/editor/index.d.ts

@@ -6,14 +6,17 @@ import { EmbedFontFaces, EmbedFontOptions } from '../fonts';
 import { History } from '../history';
 import { BlockRegistry } from './internal/blockRegistry';
 import { countBlocks } from './internal/positionMap';
+import { EditorNumbering } from './numbering';
+import { EditorSections } from './sections';
 import { EditorSelection } from './selection';
+import { EditorStyles } from './styles';
 import { EditorTable } from './table';
-import { ApiRangeType, BlockInfo, ChangePayload, CommandBus, CommandDefinition, CommandSnapshot, EditorEvent, EditorEventPayload, EditorOptions, KeyDownPayload, OutlineItem, ParagraphPropertiesPatch, RevisionSpan, SelectionPayload, TrackChangesState, Unsubscribe, WrapTag } from './types';
+import { ApiRangeType, BlockInfo, ChangePayload, CommandBus, CommandDefinition, CommandSnapshot, EditorEvent, EditorEventPayload, EditorOptions, KeyDownPayload, NamedStylePatch, OutlineItem, ParagraphPropertiesPatch, RevisionSpan, SectionPropertiesPatch, SelectionPayload, TrackChangesState, Unsubscribe, WrapTag } from './types';
 import * as Y from "yjs";
 export { EditorCommands } from './commands';
 export { EditorSelection } from './selection';
 export type { BlockRef, EditError, EditResult, InlinePosition, Selection };
-export type { ApiRangeType, BlockInfo, ChangePayload, CommandBus, CommandDefinition, CommandSnapshot, EditorEvent, EditorEventPayload, EditorOptions, KeyDownPayload, OutlineItem, ParagraphPropertiesPatch, RevisionSpan, SelectionPayload, TrackChangesState, Unsubscribe, WrapTag, };
+export type { ApiRangeType, BlockInfo, ChangePayload, CommandBus, CommandDefinition, CommandSnapshot, EditorEvent, EditorEventPayload, EditorOptions, KeyDownPayload, NamedStylePatch, OutlineItem, ParagraphPropertiesPatch, RevisionSpan, SectionPropertiesPatch, SelectionPayload, TrackChangesState, Unsubscribe, WrapTag, };
 export type { CellRef, InsertAt, InsertColumnOpts, InsertRowOpts, MergeCellsOpts, } from './types';
 export { runsLength } from '../doc/runs';
 export type { RunPropertiesPatch };
@@ -42,6 +45,27 @@ export declare class Editor {
      * and inherits optimistic-lock checking via `replaceBlock`.
      */
     readonly table: EditorTable;
+    /**
+     * Section-level edit operations — page size / margins, columns,
+     * header/footer references, vertical alignment. Grouped here (rather
+     * than as flat `Editor` methods) so the facade stays thin as the
+     * edit-op surface grows. Every method returns an `EditResult`.
+     */
+    readonly sections: EditorSections;
+    /**
+     * Named-style edit operations — define / update / remove the style
+     * definitions content resolves through. Applying a `styleId` to content
+     * is `applyBlockProperties` / `applyRunProperties`; this manages the
+     * definitions themselves. Every method returns an `EditResult`.
+     */
+    readonly styles: EditorStyles;
+    /**
+     * Numbering / list-definition edit operations — define / update / remove
+     * the list formats paragraphs reference by `numId`. Pointing a paragraph
+     * at a list is `applyBlockProperties`; this manages the definitions.
+     * Every method returns an `EditResult`.
+     */
+    readonly numbering: EditorNumbering;
     /**
      * Named-command registry — the coordination point between plugins.
      * Plugins register commands on attach and unregister on detach;

package/dist/editor/internal/mutations.d.ts

@@ -1,6 +1,6 @@
 import { RunPropertiesPatch } from '../../doc/runs';
-import { Block, ParagraphProperties, RunProperties, SectionProperties, SobreeDocument } from '../../doc/types';
-import { ParagraphPropertiesPatch, WrapTag } from '../types';
+import { Block, NamedStyle, ParagraphProperties, RunProperties, SectionProperties, SobreeDocument } from '../../doc/types';
+import { NamedStylePatch, ParagraphPropertiesPatch, SectionPropertiesPatch, WrapTag } from '../types';
 /**
  * One registry-level operation produced by a mutation. The caller
  * applies these to the BlockRegistry after committing the new doc:
@@ -49,6 +49,19 @@ export declare function mergeSectionsAcross(sections: readonly SectionProperties
  * overwrites.
  */
 export declare function mergeParagraphProps(prev: ParagraphProperties, patch: ParagraphPropertiesPatch): ParagraphProperties;
+/**
+ * Merge a {@link SectionPropertiesPatch} onto existing section properties.
+ * `pageSize` / `pageMargins` are FIELD-merged (a partial stays valid); the
+ * other fields replace wholesale. For the optional fields (`columns`,
+ * `titlePage`, `type`, `vAlign`) an explicit `undefined` clears them, while
+ * the required `headerRefs` / `footerRefs` only replace when present.
+ */
+export declare function mergeSectionProps(prev: SectionProperties, patch: SectionPropertiesPatch): SectionProperties;
+/** Merge a {@link NamedStylePatch} onto an existing style. Each present
+ *  field replaces the style's field wholesale; an explicit `undefined`
+ *  clears an OPTIONAL field. The required `type` / `displayName` are never
+ *  cleared (an undefined for them is ignored). */
+export declare function mergeNamedStyle(prev: NamedStyle, patch: NamedStylePatch): NamedStyle;
 /**
  * Map a semantic "wrap" tag to the run-property patch that achieves it.
  * Same mapping the browser editor uses for toolbar buttons.

package/dist/editor/numbering.d.ts

@@ -0,0 +1,14 @@
+import { EditResult } from '../doc/api';
+import { NumberingDefinition, NumberingLevel } from '../doc/types';
+import { EditorContext } from './context';
+export declare class EditorNumbering {
+    private readonly ctx;
+    constructor(ctx: EditorContext);
+    /** Add a new numbering definition. Fails if `def.numId` already exists. */
+    define(def: NumberingDefinition): EditResult<void>;
+    /** Replace the levels of the definition with `numId`. Fails if missing. */
+    update(numId: number, levels: NumberingLevel[]): EditResult<void>;
+    /** Remove the definition with `numId`. Fails if missing. Paragraphs that
+     *  still reference it render without a marker. */
+    remove(numId: number): EditResult<void>;
+}

package/dist/editor/sections.d.ts

@@ -0,0 +1,15 @@
+import { EditResult } from '../doc/api';
+import { EditorContext } from './context';
+import { SectionPropertiesPatch } from './types';
+export declare class EditorSections {
+    private readonly ctx;
+    constructor(ctx: EditorContext);
+    /**
+     * Merge a patch into the section at `index`: page size / margins,
+     * columns, header/footer refs, vertical alignment. `pageSize` /
+     * `pageMargins` are field-merged (a partial stays valid); other fields
+     * replace wholesale, and an explicit `undefined` clears an optional one.
+     * Re-renders page geometry; undo-integrated.
+     */
+    setProperties(index: number, patch: SectionPropertiesPatch): EditResult<void>;
+}

package/dist/editor/styles.d.ts

@@ -0,0 +1,16 @@
+import { EditResult } from '../doc/api';
+import { NamedStyle } from '../doc/types';
+import { EditorContext } from './context';
+import { NamedStylePatch } from './types';
+export declare class EditorStyles {
+    private readonly ctx;
+    constructor(ctx: EditorContext);
+    /** Add a new style. Fails if a style with the same `id` already exists
+     *  (use {@link update} to change one). */
+    define(style: NamedStyle): EditResult<void>;
+    /** Merge a patch into the style with `id`. Fails if no such style. */
+    update(id: string, patch: NamedStylePatch): EditResult<void>;
+    /** Remove the style with `id`. Fails if no such style. Content that
+     *  still references it falls back to the cascade's defaults. */
+    remove(id: string): EditResult<void>;
+}

package/dist/editor/types.d.ts

@@ -1,7 +1,7 @@
 import { BlobStore } from '../blob';
 import { Range as ApiRange, BlockRef, EditResult, InlinePosition, Selection } from '../doc/api';
 import { RunPropertiesPatch } from '../doc/runs';
-import { Block, ParagraphAlignment, ParagraphProperties, SobreeDocument } from '../doc/types';
+import { Block, HeaderFooterRef, NamedStyle, PageMargins, PageSize, ParagraphAlignment, ParagraphProperties, SectionColumns, SectionProperties, SobreeDocument } from '../doc/types';
 /**
  * Editor-surface types — the public type vocabulary of the `Editor`
  * façade (events, payloads, command bus, options, tracked-change spans).
@@ -121,6 +121,32 @@ export interface OutlineItem {
 export type ParagraphPropertiesPatch = {
     [K in keyof ParagraphProperties]?: ParagraphProperties[K] | undefined;
 };
+/**
+ * Patch for a section's properties (page geometry, columns, header/footer
+ * refs, vertical alignment). `pageSize` / `pageMargins` are FIELD-merged
+ * into the existing values (so a partial — e.g. just `orientation` or
+ * `topTwips` — stays valid); every other field REPLACES wholesale, and an
+ * explicit `undefined` on an optional field clears it.
+ */
+export interface SectionPropertiesPatch {
+    pageSize?: Partial<PageSize>;
+    pageMargins?: Partial<PageMargins>;
+    columns?: SectionColumns | undefined;
+    headerRefs?: HeaderFooterRef[];
+    footerRefs?: HeaderFooterRef[];
+    titlePage?: boolean | undefined;
+    type?: SectionProperties["type"];
+    vAlign?: SectionProperties["vAlign"];
+}
+/**
+ * Patch for an existing named style (everything except its `id`). Each
+ * present field replaces the style's corresponding field wholesale; an
+ * explicit `undefined` clears an optional one. The required `type` /
+ * `displayName` are never cleared.
+ */
+export type NamedStylePatch = {
+    [K in keyof Omit<NamedStyle, "id">]?: NamedStyle[K] | undefined;
+};
 export type WrapTag = "sup" | "sub" | "strong" | "em" | "u" | "s" | "mark";
 /** The slice of selection state plugins read (see {@link EditorLike}). */
 export interface EditorSelectionLike {

package/dist/headless.d.ts

@@ -1,7 +1,7 @@
 import { BlobCache, BlobStore } from './blob';
 import { BlockRef, EditError, EditResult, Selection } from './doc/api';
-import { Block, ParagraphAlignment, ParagraphProperties, SobreeDocument } from './doc/types';
-import { ParagraphPropertiesPatch, BlockInfo, CommandBus, OutlineItem } from './editor';
+import { Block, NamedStyle, NumberingDefinition, NumberingLevel, ParagraphAlignment, ParagraphProperties, SobreeDocument } from './doc/types';
+import { ParagraphPropertiesPatch, BlockInfo, CommandBus, NamedStylePatch, OutlineItem, SectionPropertiesPatch } from './editor';
 import { History } from './history';
 /**
  * HeadlessSobree — a no-DOM Sobree peer for LLM agents, automation,
@@ -148,6 +148,22 @@ export declare class HeadlessSobree {
     deleteBlock(target: BlockRef): EditResult<void>;
     /** Merge a patch into each target paragraph's properties. */
     applyBlockProperties(targets: BlockRef[], patch: ParagraphPropertiesPatch): EditResult<void>;
+    /** Merge a patch into a section's properties (page geometry, columns,
+     *  header/footer refs, vertical alignment). `sectionIndex` is the
+     *  section's position in the document's `sections` array. */
+    applySectionProperties(sectionIndex: number, patch: SectionPropertiesPatch): EditResult<void>;
+    /** Add a new named style. Fails if `style.id` already exists. */
+    defineStyle(style: NamedStyle): EditResult<void>;
+    /** Merge a patch into the style with `id`. Fails if no such style. */
+    updateStyle(id: string, patch: NamedStylePatch): EditResult<void>;
+    /** Remove the style with `id`. Fails if no such style. */
+    removeStyle(id: string): EditResult<void>;
+    /** Add a new numbering definition. Fails if `def.numId` already exists. */
+    defineNumbering(def: NumberingDefinition): EditResult<void>;
+    /** Replace the levels of the definition with `numId`. Fails if missing. */
+    updateNumbering(numId: number, levels: NumberingLevel[]): EditResult<void>;
+    /** Remove the definition with `numId`. Fails if missing. */
+    removeNumbering(numId: number): EditResult<void>;
     on<E extends HeadlessEvent>(event: E, cb: (payload: HeadlessChangePayload) => void): HeadlessUnsubscribe;
     destroy(): void;
     private allBlockIds;