@betteroffice/docx 0.0.1

package/dist/styles/index.d.mts

@@ -0,0 +1,162 @@
+import { P as ParagraphFormatting, T as TextFormatting, p as TableLook } from '../formatting-DoL7KBSL.mjs';
+import { a as StyleDefinitions, S as Style, D as DocDefaults } from '../styles-VxNcXLdi.mjs';
+
+/**
+ * Style Resolver for ProseMirror Editor
+ *
+ * Resolves OOXML style definitions to final paragraph and run properties.
+ * Handles the cascade:
+ * 1. Document defaults (docDefaults)
+ * 2. Normal style (if no explicit styleId)
+ * 3. Style chain (basedOn inheritance - already resolved by styleParser)
+ * 4. Inline properties
+ *
+ * Based on ECMA-376 style cascade rules.
+ */
+
+/**
+ * Resolved style properties ready for rendering
+ */
+interface ResolvedParagraphStyle {
+    /** Paragraph formatting (alignment, spacing, indentation, etc.) */
+    paragraphFormatting?: ParagraphFormatting;
+    /** Default run formatting from the style */
+    runFormatting?: TextFormatting;
+}
+/**
+ * StyleResolver provides efficient access to resolved style properties
+ */
+declare class StyleResolver {
+    private readonly stylesById;
+    private readonly docDefaults;
+    private readonly defaultParagraphStyle;
+    private readonly defaultTableStyle;
+    private readonly defaultCharacterStyle;
+    constructor(styleDefinitions: StyleDefinitions | undefined);
+    /**
+     * Get a style by ID
+     */
+    getStyle(styleId: string): Style | undefined;
+    /**
+     * Get all available paragraph styles (for toolbar dropdown)
+     */
+    getParagraphStyles(): Style[];
+    /**
+     * Whether a paragraph style with the given id is defined in the
+     * document's `styles.xml`. Used by the agent toolkit to refuse
+     * `set_paragraph_style({ styleId: 'NoSuchStyle' })` instead of
+     * silently writing an invalid `<w:pStyle>` reference.
+     */
+    hasParagraphStyle(styleId: string): boolean;
+    /**
+     * Resolve paragraph style properties, including docDefaults cascade
+     *
+     * @param styleId - The style ID to resolve (e.g., 'Heading1', 'Normal')
+     * @returns Resolved paragraph and run formatting
+     */
+    resolveParagraphStyle(styleId: string | undefined | null): ResolvedParagraphStyle;
+    /**
+     * Resolve the style applied to the paragraph that follows one styled with
+     * `styleId` when the user presses Enter (OOXML `w:next`, §17.7.4.10).
+     *
+     * Returns null when the style has no `w:next`, when `next` points back at
+     * the same style (the common heading-stays-heading case is handled by the
+     * caller), or when the style is unknown.
+     */
+    getNextStyleId(styleId: string | undefined | null): string | null;
+    /**
+     * Get all available table styles (for style gallery)
+     */
+    getTableStyles(): Style[];
+    /**
+     * Resolve run (character) style properties
+     *
+     * @param styleId - The character style ID to resolve
+     * @returns Resolved text formatting
+     */
+    resolveRunStyle(styleId: string | undefined | null): TextFormatting | undefined;
+    /**
+     * Get a character style's own properties WITHOUT docDefaults.
+     * Used when the caller already has docDefaults applied (e.g., from paragraph style resolution).
+     * This prevents docDefault fonts from incorrectly overriding paragraph style fonts.
+     */
+    getRunStyleOwnProperties(styleId: string | undefined | null): TextFormatting | undefined;
+    /**
+     * Get document defaults
+     */
+    getDocDefaults(): DocDefaults | undefined;
+    /**
+     * Get default paragraph style (usually "Normal")
+     */
+    getDefaultParagraphStyle(): Style | undefined;
+    /**
+     * Get the default table style (the one marked `w:default="1"`).
+     *
+     * Per ECMA-376 §17.7.4.18, tables that don't specify a `w:tblStyle`
+     * inherit from this style. The styleId varies by document language
+     * ("Normal Table", "TableNormal", "Tabelanormal", etc.) — find it by
+     * the parsed `default` flag, not by name.
+     */
+    getDefaultTableStyle(): Style | undefined;
+    /**
+     * Get the default character style (the one marked `w:default="1"`).
+     *
+     * Per ECMA-376 §17.7.4.18, runs without an explicit `w:rStyle` reference
+     * inherit from this style. The styleId varies by document language
+     * ("Default Paragraph Font", "FontePadrao", "Fontepargpadro" in
+     * Portuguese fixtures, etc.) — find it by the parsed `default` flag.
+     */
+    getDefaultCharacterStyle(): Style | undefined;
+    /**
+     * Check if a style exists
+     */
+    hasStyle(styleId: string): boolean;
+    private findDefaultStyle;
+    private mergeStyleIntoResult;
+    /**
+     * Merge paragraph formatting (source overrides target)
+     */
+    private mergeParagraphFormatting;
+    private mergeTextFormatting;
+}
+/**
+ * Create a style resolver from document's style definitions
+ */
+declare function createStyleResolver(styleDefinitions: StyleDefinitions | undefined): StyleResolver;
+
+/**
+ * Which table style a freshly inserted table should wear.
+ *
+ * Both insert paths (toolbar and agent) call into here so a new table picks
+ * up the document's own table look instead of a bare black grid. The
+ * document can express that look two ways, and we trust them in order of
+ * specificity: an explicit `w:defaultTableStyle` in settings.xml
+ * (§17.15.1.44) wins when it points at a real style; failing that, a table
+ * style marked `w:default="1"` (§17.7.4.18) is used — except when that
+ * default is only the formatting-free base ("Table Normal"), which every
+ * table already inherits and which would add nothing. With neither present
+ * the caller keeps its plain-border fallback.
+ *
+ * We deliberately never guess by probing for the TableGrid builtin: a
+ * document may ship that style without meaning it as its insert default,
+ * and the two spec elements above are how templates state intent.
+ */
+
+/**
+ * `tblLook` Word applies to a brand-new table (val="04A0"): style the first
+ * row and first column, enable horizontal banding, disable vertical banding.
+ * Setting this lets a resolved table style paint its header-row and banding
+ * conditional formatting on the inserted table, matching how Word renders a
+ * fresh table created with that style.
+ */
+declare const DEFAULT_NEW_TABLE_LOOK: TableLook;
+/**
+ * StyleId a brand-new table should adopt, or `undefined` when the document
+ * declares nothing usable (the caller then keeps its plain-border default).
+ *
+ * @param settingsStyleId - `w:defaultTableStyle` from settings.xml
+ * @param styles - the document's style resolver (null when unavailable)
+ */
+declare function pickTableStyleForInsert(settingsStyleId: string | undefined | null, styles: StyleResolver | null | undefined): string | undefined;
+
+export { DEFAULT_NEW_TABLE_LOOK, type ResolvedParagraphStyle, StyleResolver, createStyleResolver, pickTableStyleForInsert };

package/dist/styles/index.mjs

@@ -0,0 +1 @@
+export{d as DEFAULT_NEW_TABLE_LOOK,b as StyleResolver,c as createStyleResolver,e as pickTableStyleForInsert}from'../chunk-KXNZFTTK.mjs';import'../chunk-TTRUPDAB.mjs';

package/dist/styles-VxNcXLdi.d.mts

@@ -0,0 +1,189 @@
+import { T as TextFormatting, P as ParagraphFormatting, o as TableFormatting, s as TableRowFormatting, n as TableCellFormatting } from './formatting-DoL7KBSL.mjs';
+
+/**
+ * Styles, Theme, Font Table, Relationships & Media Types
+ *
+ * Types for document-level definitions that don't form the content tree.
+ */
+
+/**
+ * Style type
+ */
+type StyleType = 'paragraph' | 'character' | 'numbering' | 'table';
+/**
+ * Style definition from `styles.xml` — a named, reusable bundle of
+ * paragraph and/or character formatting. Word's "Heading 1", "Normal",
+ * "Title", and "List Bullet" are styles; user-defined styles look the
+ * same. `basedOn` chains styles for inheritance; `link` pairs a paragraph
+ * style with a matching character style.
+ *
+ * See ECMA-376 §17.7.4.
+ */
+interface Style {
+    /** Style ID */
+    styleId: string;
+    /** Style type */
+    type: StyleType;
+    /** Display name */
+    name?: string;
+    /** Based on style ID */
+    basedOn?: string;
+    /** Next style after Enter (for paragraph styles) */
+    next?: string;
+    /** Linked style (paragraph/character pair) */
+    link?: string;
+    /** UI sort priority */
+    uiPriority?: number;
+    /** Hidden from UI */
+    hidden?: boolean;
+    /** Semi-hidden from UI */
+    semiHidden?: boolean;
+    /** Unhide when used */
+    unhideWhenUsed?: boolean;
+    /** Quick format in gallery */
+    qFormat?: boolean;
+    /** Is default style */
+    default?: boolean;
+    /** Personal style (custom) */
+    personal?: boolean;
+    /** Paragraph properties (for paragraph/table styles) */
+    pPr?: ParagraphFormatting;
+    /** Run properties */
+    rPr?: TextFormatting;
+    /** Table properties (for table styles) */
+    tblPr?: TableFormatting;
+    /** Table row properties */
+    trPr?: TableRowFormatting;
+    /** Table cell properties */
+    tcPr?: TableCellFormatting;
+    /** Conditional table style parts */
+    tblStylePr?: Array<{
+        type: 'band1Horz' | 'band1Vert' | 'band2Horz' | 'band2Vert' | 'firstCol' | 'firstRow' | 'lastCol' | 'lastRow' | 'neCell' | 'nwCell' | 'seCell' | 'swCell';
+        pPr?: ParagraphFormatting;
+        rPr?: TextFormatting;
+        tblPr?: TableFormatting;
+        trPr?: TableRowFormatting;
+        tcPr?: TableCellFormatting;
+    }>;
+}
+/**
+ * Document defaults (w:docDefaults)
+ */
+interface DocDefaults {
+    /** Default run properties */
+    rPr?: TextFormatting;
+    /** Default paragraph properties */
+    pPr?: ParagraphFormatting;
+}
+/**
+ * Style definitions from styles.xml
+ */
+interface StyleDefinitions {
+    /** Document defaults */
+    docDefaults?: DocDefaults;
+    /** Latent styles */
+    latentStyles?: {
+        defLockedState?: boolean;
+        defUIPriority?: number;
+        defSemiHidden?: boolean;
+        defUnhideWhenUsed?: boolean;
+        defQFormat?: boolean;
+        count?: number;
+    };
+    /** Style definitions */
+    styles: Style[];
+}
+
+/**
+ * Font info from fontTable.xml
+ */
+interface FontInfo {
+    /** Font name */
+    name: string;
+    /** Alternate names */
+    altName?: string;
+    /** Panose-1 classification */
+    panose1?: string;
+    /** Character set */
+    charset?: string;
+    /** Font family type */
+    family?: 'decorative' | 'modern' | 'roman' | 'script' | 'swiss' | 'auto';
+    /** Pitch (fixed or variable) */
+    pitch?: 'default' | 'fixed' | 'variable';
+    /** Signature */
+    sig?: {
+        usb0?: string;
+        usb1?: string;
+        usb2?: string;
+        usb3?: string;
+        csb0?: string;
+        csb1?: string;
+    };
+    /** Embedded regular face (`w:embedRegular`) */
+    embedRegular?: FontEmbed;
+    /** Embedded bold face (`w:embedBold`) */
+    embedBold?: FontEmbed;
+    /** Embedded italic face (`w:embedItalic`) */
+    embedItalic?: FontEmbed;
+    /** Embedded bold-italic face (`w:embedBoldItalic`) */
+    embedBoldItalic?: FontEmbed;
+}
+/**
+ * A single embedded font face referenced from `fontTable.xml`. The font binary
+ * lives at the relationship target (an obfuscated `.odttf` under `word/fonts/`)
+ * and is descrambled with `fontKey`. See `utils/fontDeobfuscation.ts`.
+ */
+interface FontEmbed {
+    /** Relationship ID (`r:id`) resolved via `word/_rels/fontTable.xml.rels`. */
+    relId: string;
+    /** Obfuscation key GUID (`w:fontKey`), e.g. `{XXXXXXXX-....}`. */
+    fontKey?: string;
+    /** Whether the embedded face is subsetted (`w:subsetted`). */
+    subsetted?: boolean;
+}
+/**
+ * Font table from fontTable.xml
+ */
+interface FontTable {
+    fonts: FontInfo[];
+}
+/**
+ * Relationship type
+ */
+type RelationshipType = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/image' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/header' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/oleObject' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData' | string;
+/**
+ * Relationship entry
+ */
+interface Relationship {
+    /** Relationship ID (e.g., "rId1") */
+    id: string;
+    /** Relationship type URI */
+    type: RelationshipType;
+    /** Target path or URL */
+    target: string;
+    /** Target mode */
+    targetMode?: 'External' | 'Internal';
+}
+/**
+ * Relationship map (keyed by rId)
+ */
+type RelationshipMap = Map<string, Relationship>;
+/**
+ * Media file from word/media/
+ */
+interface MediaFile {
+    /** File path in ZIP */
+    path: string;
+    /** Original filename */
+    filename?: string;
+    /** MIME type */
+    mimeType: string;
+    /** Binary data */
+    data: ArrayBuffer;
+    /** Base64 encoded data for rendering */
+    base64?: string;
+    /** Data URL for direct use in src attributes */
+    dataUrl?: string;
+}
+
+export type { DocDefaults as D, FontTable as F, MediaFile as M, Relationship as R, Style as S, StyleDefinitions as a, RelationshipMap as b, FontEmbed as c, FontInfo as d, RelationshipType as e, StyleType as f };