@sobree/core 0.1.45 → 0.1.47

package/dist/doc/styles.d.ts

@@ -1,4 +1,19 @@
 import { NamedStyle, ParagraphProperties, RunProperties, SobreeDocument } from './types';
+/**
+ * Merge one run-property layer of the STYLE hierarchy onto the accumulated
+ * base. Non-toggle fields override (leaf wins). For toggle fields the layer's
+ * value decides:
+ *   - absent (`undefined`)  → keep the inherited value;
+ *   - `true` (a `<w:b/>` re-declaration) → XOR: toggle the inherited value, so
+ *     a `caps` style based on another `caps` style CANCELS to off;
+ *   - `false` (an explicit `<w:b w:val="0"/>`) → RESET to off. An explicit off
+ *     is a definite "not bold", not a toggle — so a style that turns off the
+ *     bold it inherited (ACM's `ACMRef` off `Titledocument`) renders upright.
+ *
+ * NOT used for DIRECT run formatting: there a plain spread applies, so an
+ * explicit run-level `false` overrides the resolved style value outright.
+ */
+export declare function mergeRunStyleLayer(base: RunProperties, over: RunProperties): RunProperties;
 /**
  * Style-cascade resolver — walks `styleId` up its `basedOn` chain and
  * merges defaults base-first, leaf-last. The result is what the

package/dist/docx/import/runProperties.d.ts

@@ -0,0 +1,26 @@
+import { RunProperties } from '../../doc/types';
+/**
+ * The single reader for a `<w:rPr>` (run-properties) element.
+ *
+ * `<w:rPr>` is ONE OOXML concept with two homes: inside a `<w:r>` (direct
+ * run formatting) and inside a `<w:style>` (a style's run defaults). It
+ * must therefore have ONE reader — parsing it in two places is what let
+ * the run and style paths drift (direct runs silently lost double
+ * underline and colour="auto"; the tri-state toggle logic was written,
+ * and bug-fixed, twice). Both importers call this; the two homes can no
+ * longer diverge.
+ *
+ * The result is the native `RunProperties` shape directly — no
+ * intermediate "RunFormat" type, no mapping layer.
+ *
+ * Toggle properties (b/i/strike/caps) are read TRI-STATE via
+ * {@link wToggleOn}: present→true, `w:val="0"`→false, absent→undefined.
+ * The `false` is load-bearing at both sites (see `wToggleOn`). Combining
+ * toggles across the style hierarchy (XOR / reset) is the resolver's job
+ * (doc/styles.ts `mergeRunStyleLayer`), not this reader's — here we only
+ * record each element's raw value.
+ *
+ * Returns `undefined` when the rPr contributes nothing, so callers can
+ * treat "no properties" uniformly.
+ */
+export declare function readRunProperties(rPr: Element): RunProperties | undefined;

package/dist/docx/import/runs.d.ts

@@ -1,4 +1,4 @@
-import { RunFormat } from '../types';
+import { RunProperties } from '../../doc/types';
 /** Frame-of-reference choices the importer carries through; mapped 1:1 to
  *  the `DrawingAnchor.relativeFromH` / `relativeFromV` AST values. */
 export interface ImportedAnchor {
@@ -26,7 +26,7 @@ export interface ImportedDrawing {
  */
 export interface ImportedRun {
     text: string;
-    format: RunFormat;
+    format: RunProperties;
     /** True if this run was `<w:br/>`; `text` is empty in that case. */
     isHardBreak: boolean;
     /** Type of break for `isHardBreak` runs — line (Shift-Enter), page

package/dist/docx/shared/xml.d.ts

@@ -29,6 +29,21 @@ export declare function wVal(el: Element | null): string | null;
  * a page break before every paragraph.
  */
 export declare function wOnOff(root: Document | Element, localName: string): boolean;
+/**
+ * TRI-STATE read of an OOXML toggle property (`CT_OnOff`: `<w:b>`,
+ * `<w:caps>`, …) from an already-resolved element. Unlike {@link wOnOff}
+ * this distinguishes "absent" from "explicit-off":
+ *   - element absent (`null`)             → `undefined` (inherit);
+ *   - present, no `w:val` (bare `<w:b/>`) → `true`;
+ *   - `w:val` "0" / "false"               → `false` (explicit off).
+ *
+ * The `false` is load-bearing at BOTH `<w:rPr>` sites: a direct run's
+ * `<w:caps w:val="0"/>` overrides an inherited toggle, and a style's
+ * explicit-off resets it as the cascade combines (`mergeRunStyleLayer`).
+ * Toggle XOR-combination across the style hierarchy is the resolver's job
+ * (doc/styles.ts), not the reader's — this only records the raw value.
+ */
+export declare function wToggleOn(el: Element | null): boolean | undefined;
 /** Build an XML declaration header + root element. Used by the exporter. */
 export declare function xmlDocument(rootXml: string): string;
 /**

package/dist/docx/types.d.ts

@@ -16,39 +16,6 @@ export interface DocxExportResult {
     bytes: Uint8Array;
     warnings: string[];
 }
-/** A single inline run's formatting flags — what `<w:rPr>` tells us. */
-export interface RunFormat {
-    /** `<w:rStyle w:val="…">` — a character style applied to the run. Its
-     *  rPr (colour, underline, …) is resolved against the style cascade at
-     *  render time, under any direct run formatting. */
-    styleId?: string;
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    strike?: boolean;
-    /** `<w:caps/>` — render the run with `text-transform: uppercase`. */
-    caps?: boolean;
-    /** CSS-ready `#rrggbb`. */
-    color?: string;
-    /** Highlight colour name or CSS-ready `#rrggbb`. */
-    highlight?: string;
-    /** CSS-ready `font-family` value. */
-    fontFamily?: string;
-    /** Size in pt. */
-    fontSizePt?: number;
-    verticalAlign?: "subscript" | "superscript";
-    /**
-     * `<w:rPrChange>` — a snapshot of the run's properties before the
-     * most recent tracked format edit. The inner `<w:rPr>` is parsed
-     * into the same `RunFormat` shape (recursion-free: the snapshot
-     * itself doesn't carry an `revisionFormat`).
-     */
-    revisionFormat?: {
-        before: RunFormat;
-        author?: string;
-        date?: string;
-    };
-}
 /** Paragraph-level formatting — from `<w:pPr>`. */
 export interface ParagraphFormat {
     /** 1..6 if the paragraph carries a `Heading{N}` style; 0 otherwise. */

package/dist/editor/view/docRenderer/inline.d.ts

@@ -1,4 +1,4 @@
-import { InlineRun, NamedStyle } from '../../../doc/types';
+import { InlineRun, NamedStyle, RunProperties } from '../../../doc/types';
 /**
  * Render a list of InlineRuns into DOM children of `parent`. Empty run
  * lists produce a `<br>` placeholder so contenteditable can place a
@@ -7,7 +7,7 @@ import { InlineRun, NamedStyle } from '../../../doc/types';
  * `rawParts` is threaded through so `DrawingRun` can resolve its
  * `partPath` to an `<img src>` via a blob URL / data URI.
  */
-export declare function appendInlineRuns(parent: HTMLElement, runs: readonly InlineRun[], rawParts?: Record<string, Uint8Array>, styles?: readonly NamedStyle[]): void;
+export declare function appendInlineRuns(parent: HTMLElement, runs: readonly InlineRun[], rawParts?: Record<string, Uint8Array>, styles?: readonly NamedStyle[], paragraphRunDefaults?: RunProperties): void;
 /** Convert a raw part's bytes (from `doc.rawParts`) into a blob URL
  *  the browser can render as `<img src>` / `background-image`. Exported
  *  for the section-frame renderer in `block.ts` which paints the

package/dist/editor/view/docRenderer/properties.d.ts

@@ -1,2 +1,2 @@
-import { NamedStyle, ParagraphProperties } from '../../../doc/types';
-export declare function applyParagraphProps(el: HTMLElement, props: ParagraphProperties, styles?: readonly NamedStyle[]): void;
+import { NamedStyle, ParagraphProperties, RunProperties } from '../../../doc/types';
+export declare function applyParagraphProps(el: HTMLElement, props: ParagraphProperties, styles?: readonly NamedStyle[]): RunProperties;