@sobree/core 0.1.0

package/dist/doc/pageSetupBridge.d.ts

@@ -0,0 +1,26 @@
+import { PageSetup } from '../paperStack/pageSetup';
+import { Block, SectionProperties } from './types';
+export interface SectionMaterials {
+    section: SectionProperties;
+    headerFooterBodies: Record<string, Block[]>;
+}
+/**
+ * Translate `PageSetup` → `SectionProperties` plus the header/footer body
+ * blocks. Allocates part ids (`header1.xml`, `footer1.xml`, …) following
+ * Word's canonical numbering.
+ */
+export declare function pageSetupToSection(setup: PageSetup): SectionMaterials;
+/**
+ * Translate `SectionProperties` + header/footer bodies → a sparse
+ * `Partial<PageSetup>`. Keys are only present if the section actually
+ * specified them, so callers can merge cleanly with their current setup.
+ */
+export declare function sectionToPageSetup(section: SectionProperties, bodies: Record<string, Block[]>): Partial<PageSetup>;
+/**
+ * Parse a header/footer template (plain text with `{page}` / `{pages}`
+ * tokens) into Block[] — one paragraph per line. Field tokens become
+ * FieldRun nodes so Word's PAGE/NUMPAGES field codes emit naturally.
+ */
+export declare function templateToBlocks(template: string): Block[];
+/** Reverse of `templateToBlocks`. Used on import. */
+export declare function blocksToTemplate(blocks: readonly Block[]): string;

package/dist/doc/parts.d.ts

@@ -0,0 +1,18 @@
+import { SobreeDocument } from './types';
+/**
+ * Walk the document and return the set of `rawParts` keys that
+ * something in the AST still points at. Anything else is an orphan.
+ */
+export declare function collectLivePartPaths(doc: SobreeDocument): Set<string>;
+/**
+ * Return a new document whose `rawParts` only contains live keys.
+ * Reports which keys were dropped. The document is otherwise unchanged
+ * — no AST mutation, no version bumps, no header/footer churn.
+ *
+ * Idempotent: pruning an already-clean doc is a no-op.
+ */
+export declare function pruneOrphanParts(doc: SobreeDocument): {
+    doc: SobreeDocument;
+    kept: number;
+    pruned: string[];
+};

package/dist/doc/runs.d.ts

@@ -0,0 +1,47 @@
+import { InlineRun, RunProperties } from './types';
+/**
+ * Character-length of a single InlineRun, matching the counting rules
+ * used by the DOM ↔ position map:
+ *   - TextRun → `text.length`.
+ *   - BreakRun / TabRun / DrawingRun → 1 each.
+ *   - FieldRun → length of its cached value (empty = 0).
+ *   - HyperlinkRun → sum of its children's lengths.
+ */
+export declare function runLength(run: InlineRun): number;
+export declare function runsLength(runs: readonly InlineRun[]): number;
+/**
+ * Split a runs array at `offset` characters from the start. Returns two
+ * arrays whose concatenated content is equivalent to the input. Splitting
+ * *through* a TextRun produces two TextRuns with the same properties;
+ * splitting through an atom puts the whole atom on one side (ties go to
+ * "before" at the atom's end boundary and "after" at the start boundary).
+ */
+export declare function splitRunsAt(runs: readonly InlineRun[], offset: number): {
+    before: InlineRun[];
+    after: InlineRun[];
+};
+/**
+ * Slice a runs array between two character offsets (inclusive `from`,
+ * exclusive `to`). Used by `applyRunProperties` / `wrapRange` to isolate
+ * the affected middle section.
+ */
+export declare function sliceRuns(runs: readonly InlineRun[], from: number, to: number): InlineRun[];
+/**
+ * Patch shape accepted by `applyRunPropertiesToRuns`. Keys set to
+ * `undefined` remove the corresponding property from affected runs;
+ * keys set to a value override.
+ */
+export type RunPropertiesPatch = {
+    [K in keyof RunProperties]?: RunProperties[K] | undefined;
+};
+/**
+ * Return a new runs array with `patch` merged into every TextRun's
+ * properties (and recursively into HyperlinkRun children). Atoms
+ * without `properties` pass through unchanged.
+ */
+export declare function applyRunPropertiesToRuns(runs: readonly InlineRun[], patch: RunPropertiesPatch): InlineRun[];
+/**
+ * Concatenate runs and merge adjacent TextRuns with identical property
+ * shapes. Minor cleanup for operations that leave fragmentation behind.
+ */
+export declare function mergeAdjacentTextRuns(runs: readonly InlineRun[]): InlineRun[];

package/dist/doc/styles.d.ts

@@ -0,0 +1,19 @@
+import { NamedStyle, ParagraphProperties, RunProperties, SobreeDocument } from './types';
+/**
+ * Style-cascade resolver — walks `styleId` up its `basedOn` chain and
+ * merges defaults base-first, leaf-last. The result is what the
+ * renderer should apply (block element inherits these to its runs)
+ * and what the toolbar's font / mark dropdowns should reflect.
+ *
+ * Falls back to the document's `Normal` style at the end of the chain
+ * so a paragraph with no explicit style still picks up the document's
+ * baseline run / paragraph defaults (see `defaultStyles()` in
+ * `./builders`).
+ *
+ * Cycles in `basedOn` are tolerated — we de-dupe by id and stop
+ * walking. Missing styles are silently skipped.
+ */
+export declare function resolveStyleCascade(styles: readonly NamedStyle[] | SobreeDocument, styleId: string | undefined): {
+    runDefaults: RunProperties;
+    paragraphDefaults: ParagraphProperties;
+};